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Chapter 1 Introduction 


1.1 Before You Begin 


This manual describes the Structure Builder. Structure Builder is the basic tool for all the other 
Builders of AdvaBuild Engineering Software. With this Builder you can create Advant objects, 
design structures, and add aspects to Advant objects. Afterwards other Builders can work on 
these aspects. 


This book is not intended to be the sole source of instruction for engineering tools. Those people 
involved in system engineering should attend the applicable system engineering courses offered 
by ABB. 


The reader of this book should have good knowledge about engineering in general and the work 
flow used in his project. 


1.2 Equipment Requirements 
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For a description of the system requirements consult the Release Notes of Advant Engineering 
Workplace and the Release Notes of the individual Builders. 
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1.3 How to Use This Book 


This book is organized into chapters and sections as shown in Figure 1-1. 
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Before You General. Considerations Operating Error Appendix A 
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Terminology 
Product 
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User Interface 


Figure 1-1. Organization of Manual 


The main part of this users guide is placed in Chapter 3, Configuration/Application Building. 
Here you will find general considerations, application procedures, and as a reference part, a 
description of all menu commands. 


1.4 Conventions 


The names of referenced manuals are written in italics. 


Keyboard interaction 


When you read 


File | Copy 


Cirl+M 


You shall 


Open the File menu, choose the item Copy, and click it with left 
mouse button 


Press the Ctrl key and the key labelled M simultaneously 
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1.5 Related Documentation 
Table 1-1 shows related documentation. 


Table 1-1. Related Documentation 


Category Title Description 
Station Advant Station 100 Series Engineering Station | Describes the hardware and setup of Advant 
User's Guide Station 100 Series Engineering Station 


including the Advant Station 100 Series 
Engineering Board 


Software AMPL Control Configuration Functions User’s | Describes the handling of control configuration 
Guide related aspects of Advant objects into the 
Structure Builder 


Options Parameter Builder User’s Guide Describes how to handle parameters for 
process objects and for OCS objects 


Document Builder User’s Guide Describes the handling of templates and of 
various types of document aspects belonging 
to Advant objects 


Other Bulk Data Handling and Reuse Reference Describes the working with Structure Builder’s 
Manual Import/Export functions 
Engineering Methods User’s Guide Describes the principles of engineering based 


on the Advant object concept 


1.6 Release History 


Table 1-2 lists the major milestones in the development of Structure Builder User’s Guide 


Table 1-2. Release History 


Version Description 
3BSE013932R0001 | Describes the Structure Builder 3.0/0 
3BSE013932R0101 | Describes the Structure Builder 3.1/0 
3BSE013932R201 | Describes the Structure Builder 3.2 


1.7 Terminology 


See Appendix B, Glossary of Terms.. 
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1.8 Product Overview 


Structure Builder is the basic tool for creation and administration of Advant objects. Further on 
it is a browser for structures, to show the hierarchical relations between Advant objects. From 
Structure Builder all other Builders will be started. Therefore it is a general prerequisite for all 
other Builders. 


1.9 User Interface 


The functions of Structure Builder are implemented by Windows programs with the typical 
graphic user interface and look-and-feel of Windows programs. 


The dialogs that will appear on the screen, normally have Help buttons. Clicking this button will 
open the Structure Builder’s on-line help, where you will get context-sensitively help to the 
actual topic. 
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Chapter 2 Installation 


2.1 General Information 


See Advant Engineering Workplace Release Notes and Structure Builder Release Notes. 
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Chapter 3 Configuration/Application Building 


3.1 Considerations 


3.1.1 Summary of AdvaBuild Engineering Software 
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This section covers the engineering software for the Advant Open Control System with 
Master Software. The engineering software consists of a set of cooperating tools named 
Builders. The tool set is referred to as the AdvaBuild Engineering Software. 


All tools of the AdvaBuild Engineering Software base on the Advant Object Technology. This 
underlying concept utilizes a rich base of real-world experiences to make the complex 
engineering process during its whole life cycle simple, accessible, and intuitive. AdvaBuild 
Engineering Software as the incorporation of the Advant object concept provides the engineers 
with extensive capabilities and cutting-edge technologies. The following sections give an 
overview of the Advant object technology and AdvaBuild Engineering Software. 


The engineering software supports: 

* Many phases and tasks of the engineering process from plant design to maintenance 
¢ Different project type 

° Various working methods 

° Reuse of existing solutions and import of engineering data for efficient working. 


The engineering software is based on an object oriented concept, the Advant object 
technology. That offers a methodology to model a plant for engineering purposes (see 

Figure 3-1), and to structure and handle the complete engineering data using Advant objects. All 
relevant data for one object like a motor with all its aspects such as specifications, control logic 
and CAD-drawings are kept together and are easily accessible. 
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Figure 3-1. Engineering Model for a Plant 


The engineering software supports various working methods with a uniform and scalable set of 


tools. These tools cooperate with each other by common mechanisms. They run on scalable 
hardware environments, like 


Stand-alone personal computers (PCs) not connected to a network 


° Networked PCs with a data server. 


3.1.2 The Engineering Process 


3-2 


In order to produce high quality results, the engineering process shall be treated in a well- 
structured, reproducible, and documented manner. These issues are necessary to work in 
accordance to ISO 9000. 


The engineering process can be divided into different engineering phases, where typical 
engineering work is executed. Engineering work shall not be restricted to one given work flow 


model. You can enter data whenever they are available and refine them in later phases, when 
more details are specified. 
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Engineering Project Phases 


The engineering process for a project can be divided into several engineering phases (see 
Figure 3-2): 


° Bid and proposal 
In this phase technical and commercial frame conditions for the project are defined. 


¢ Plant design 
In this phase the basic definitions like structures are defined and agreements are made, 
which standards shall be followed. Here the basis for efficient work of high quality in later 
project phases is set. 


° Software production and test 
The bulk work for the OCS-part of the projects is done in this phase. If the plant design is 
made in a structured way and standards are available, engineering work can be done 
efficiently. Also the quality is improved if proven solutions are reused. 


° Installation and commissioning 
This phase is made at site and may require a frequent change/update cycle. Up to date 
information is very important. 


* Maintenance 
As data are available in a structured way from the previous project phases, maintenance 
personnel has fast and easy access to up to date information. This is the basis for quick 
analysis and changes. 


In parallel to the above mentioned phases the following activities exist in a project: 


° Project management 
to organize and control the progress of the project 


° Supply chain coordination 
to organize and control all necessary deliveries for the project. 


Engineering tools focus on an efficient support for plant design, software production and test, 
installation and commissioning, and maintenance. Nevertheless, information can be accessed 
from the bid and proposal phase (like specifications) and from the supply chain coordination 

(like delivery data) for reuse in the engineering process if they are available in electronically 

readable format. 
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Bid & Software Installation and Main- 
Proposal Production Commissioning tenance 
and Test 


Figure 3-2. Engineering Process and Its Phases 


Project Types 
Depending on the scope of supply we can distinguish between the following project types: 


«  Advant OCS engineering project 
This project scope is focused to supply the controller and MMI configuration of Advant 
OCS. 


° Plant engineering project 
Plant engineering projects cover — in addition to Advant OCS engineering — further 
engineering activities like electrical CAD. 


* Civil engineering project 
The scope extends to building, infrastructure and mechanical engineering. 


While the first two project types are efficiently supported by the AdvaBuild Engineering 
Software, civil engineering is not focused. 


Depending on the project type, the project size and the number of project members, an adequate 
working environment can be configured out of the AdvaBuild Engineering Software. 


Working Methods 


In order to optimize the engineering process, it is recommended to standardize the engineering 
work flow for a certain project type. The tool set is flexibly adaptable to different working 
methods. 


If specification data are already available - which is typical in an early stage of the engineering 
process - it is profitable to use a bulk data oriented work flow, where these data are efficiently 
transformed into the engineering environment. 


In later stages of software production and during commissioning and maintenance a more 
interactive working method is used, where data are refined and incremental changes are done 
with the Builders). 
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Depending on organizational structures of your engineering projects the following methods are 
possible: 


¢ Task oriented work flow 
Dedicated tasks, like electrical CAD, are executed by specialists. 


¢ Function oriented work flow 
All tasks for a dedicated process section are executed by one engineer. 


The first method needs less overall knowledge for each individual person, while the second 
gives a high potential for powerful reusable solutions. 


Independent of the selected working method, the AdvaBuild Engineering Software enables you 
to distribute work in a scalable environment. During in-house engineering the complete set of 
tools may be available, whereas a stand-alone personal computer may be used during 
commissioning with a selected subset of Builders. 


Reuse of standard Engineering Solutions 


Recurring engineering tasks can be solved once and then put into a library of well tested 
standard engineering solutions. These standard engineering solutions may contain all 
engineering aspects of the object like control logic, CAD drawings, and functional descriptions. 
They can be reused and parametrized for the dedicated project whenever a similar task occurs 
again. 


Using well tested and standardized solutions increases the quality of applications and the project 
efficiency. Further on it reduces maintenance efforts. 


Standard engineering solutions can be developed the same way as ordinary project data, using 
AdvaBuild Engineering Software. 


3.1.3 Advant Object Technology 
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AdvaBuild Engineering Software is based on the Advant object technology. This technology 
deals with modeling and structuring of data. 


Information handled during the engineering process will be assigned to Advant objects. The 
Advant object technology supports modeling of a real world for engineering purposes. It keeps 
all relevant data of an object together. 


With Advant objects you can easily structure information treated in the engineering process 
phases plant design, software production and test, installation and commissioning, and 
maintenance. 


The Advant object technology defines a methodology how to handle the described items in a 
comfortable and consistent way by introducing: 


° Advant objects 
° Aspects 
° Views. 


The Advant object technology allows the concurrent access to the information by several 
engineers. 
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Figure 3-3 shows a typical example of an Advant object used in electrical and control 
engineering. 


Parameter 
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Real world object Advant object Aspects Views 


Figure 3-3. Mapping of a Real World Object into an Advant Object 


Advant Objects 

During the engineering process you may deal with different items: 
° Main plant equipment like a boiler or a casting machine 

° Components and devices like motors, cabinets and I/O-boards 
° Information entities such as signals 

° Location entities like areas, buildings etc. 


To come to a unique treatment of these items, each of them is referred to as an Advant object. 
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Aspects 


There are often several aspects of one Advant object to consider in the engineering work. An 
aspect can be defined in a way you want to handle the Advant object. For example, if the 
location of a motor within the plant’s landscape is of interest, create a location aspect of the 
motor. In another context you may find it interesting to inspect the control logic aspect of that 
motor. For wiring purposes yet another aspect may be needed. In this way you can create 
several aspects of one Advant object. 


Each aspect is typically handled by one Builder. An example is the Function Chart Builder, 
which handles control aspects. 


Views 


A view is a specific presentation of engineering data belonging to one or more aspects of an 
Advant object. An aspect may have several views. The presentation in a view gives the 
possibility to inspect and modify engineering data. 


The data may be presented for example as a list, a table, a diagram, or a drawing. 
Examples of views for a control logic aspect are: 
° Function chart 


° Textual representation such as AMPL source code. 


Creation of Structures for Advant Objects 


Advant objects can be related to each other hierarchically. This structure corresponds to the 
relation of real world objects of a plant. 


You can organize the Advant objects in different structures, such as functional or location 
structure. Advant objects are automatically put into the pool structure. The pool structure holds 
all Advant objects in a non-hierarchical list. 


A structured approach supports designation handling, for example according to IEC 750:1983 
and IEC 1082, and efficient usage of designations for example in diagrams, where designations 
may be concatenated according to the structures. 


3.1.4 Features of the Builders 
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AdvaBuild Engineering Software consists of a set of cooperating tools, called Builders, 
supporting the tasks to be performed in Advant OCS and plant engineering projects. The project 
phases plant design, software production and test, installation and commissioning and 
maintenance are supported. 


Client/Server Architecture 


Applications may consist of a client and a server part. This split in the design of the software is 
meaningful when two criteria have to be fulfilled: 


° Data consistency shall be guaranteed for several applications and team members 


° Computer load shall be balanced between several clients and the server. 
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AdvaBuild Engineering Software consists of several Builders. When you plan your 
environment, you should decide whether you want to install AdvaBuild Engineering Software 
including the Advant Engineering Server on one PC or on several PCs connected via a TCP/IP 
network (see Figure 3-4). 


PC 


Builder] |Builder] |Builder 
A B Cc 


PC1 


Builder] |Builder] |Builder 
A B Cc 


PC 2 


Builder] |Builder] |Builder 
A B Cc 


Advant 
Engineering 
Server 


Network 


Advant 


Engineering 
Server 


Figure 3-4. Installation on One PC or in a Network 


As AdvaBuild Engineering Software consists of several Builders, there are several Builders 
installed on one PC. These Builders can cooperate with others via the so-called Aspect Request 
Broker. With the help of this cooperation all aspects of Advant objects can be kept consistently 
together. When the Builders cooperate in this manner, we talk about the cooperating mode. 
The data necessary to achieve the cooperation between Builders are stored in the so-called 
Aspect Registry. 


Some Builders can also run in independent mode without cooperation. In this mode Advant 
objects are not available, only independent aspects. 
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You can combine software and hardware according to your specific needs. Several 


configurations are possible: 


° The stand-alone PC (see Figure 3-5) 


Structure Builder User’s Guide 
Section 3.1.4 Features of the Builders 


Everything is stored on the local hard disk. A typical example is an Advant Station 100 
Series Engineering Station used in a commissioning situation. The tools can be run either 


in the independent mode or in the cooperating mode (see Figure 3-4). 


° Networked PCs (see Figure 3-5) 


Data can be stored on a data server for multi-user access. An example for this 
configuration is in-house engineering.The tools can be run either in the independent mode 


or in the cooperating mode (see Figure 3-4). 


The following configurations are supported by the AdvaBuild Engineering Software: 


| aa 
[Files | —~ Server 
(Windows NT) 


Target 


Target 


Figure 3-6. Networked PCs 
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The variety of configurations offers the optimum flexibility and scalability for the creation of an 
engineering environment according to your needs. As different configurations may coexist, it is 
easy to extend and reduce the number of users within a project organization. The use of licences 
can be optimized if a certain workplace does not need all the functions available. 


It is easy to disconnect a PC from a client/server configuration to be able to work with a stand- 
alone PC and vice versa. 


Multi-user Environment 


The Builders support working in a multi-user environment. The project members have access to 
the data of the project depending on their access rights. When a member is working with an 
aspect of an Advant object, that aspect is locked, so that other project members cannot modify it 
to assure data consistency. 


Network Functions 
Beside the general client/server architecture the following network functions are available: 


° Access to controllers via the plant network (see Figure 3-6). The engineer can access 
controllers in the test field or at site from his office. 


° Storage of data on file servers in heterogeneous networks consisting of personal computers 
and workstations 


° Printing of documents of printers in heterogeneous networks. 


Scalability 


AdvaBuild Engineering Software is scalable in many respects. Therefore, the environment can 
be configured according to the project’s demands. The optimum project environment can be 
determined by the project type, number of project members, and the set of required Builders. 


User Interface 


The user interface of the Builders is easy to learn and use, as it is designed according to standard 
style guides. Depending on the underlying operating system, the tools appear in the well known 
styles of Microsoft Windows NT. 


If you are familiar with Microsoft Windows you will feel comfortable in this environment. 
Efficient methods like cut, copy and paste or drag and drop, toolbar buttons, and accelerator 
keys are available. The on-line help will immediately answer your questions while working with 
the tool. 


Project Data Administration 


AdvaBuild Engineering Software supplies functions for project data administration. It allows to 
register different users and allocate access rights and passwords. 


Backup and restore of project data is supported. 
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3.1.5 Structure Builder in General 
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Structure Builder is the basic tool to handle the Advant objects and to visualize the structure of a 
plant. The plant is represented as a set of Advant objects. Structure Builder enables you to 
navigate between Advant objects in a convenient way and to perform activities on a selected 
Advant object, such as starting a certain tool, copying or moving an Advant object, a subtree or 
a whole project. 


Several functions are provided by Structure Builder: 


° Creating, moving, and deleting of Advant objects (it is also possible to copy between 
projects and to handle absolute and relative reference designations) 


° Structuring of Advant objects in a hierarchy according to the needs of the plant and 
process structure 


° Powerful mechanisms to import engineering data in cooperation with the Parameter 
Builder 


° Navigation between Advant objects 
° Opening views on aspects. 


In Structure Builder several windows can be open simultaneously. You can open for example 
the location structure of the same project more than once. Data consistency is achieved 
independent on the window you are working with. Further on you can operate in the functional 
structure of the same project and in the location structure of another project. Figure 3-7 shows 
an example of multiple windows in Structure Builder. 
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i@@ Structure Builder 
Object Edit View Project Options Window Help 


tes & [@a|| =(s|2[% E| @ |n2| 


Project : 
Location Structure 


OCS Mounting Locations — Cabinet 

MC Mounting Locations Cabinet 
MC Cabinet ECO3 Cabinet 
a +EC03.101 MC Location 1 Slot 
MC Location 2 Slot 


Example Project EXP13RO Project 
Ladle Tower Process Object ] 
Tundish Process Object | 
CARDRIVE Drive System 

CARDRIVE_Motorstarter Control Module 
CARDRIVE_MCC Binder 
CARDAIVE_I0 Binder 
CARDAIVE_M e 


P2=M1=RUN_L CARDRIVE_RUN_L Signal 
=FB_L CARDRIVE_FB_L Signal 
=P2=M1=FB_R CARDRIVE_FB_R Signal 
Casting Machine Process Object 


Type Created Created By + 


CARDRIVE_Main_Drive Basic Property Basic Property 619/98 13:36  otmayer | 
CARDRIVE_Main_Drive Electrical Device Data El. Device 619/98 13:36 otmayer 
CARDRIVE_Main_Drive Project Pool Structure 619/98 13:36  otmayer 
CARDRIVE_Main_Drive ++ Location Structure Structure 2/899 15:44 — otmayer 
‘CARDRIVE_Main_Drive = Function Structure = Structure 61998 13:36  otmayer 
CARDRIVE_RUN_R Run Right Basic Property 649/98 1:36:59 otmayer 
CARDRIVE_RUN_R Libray Ref. Basic Property 6/23/98 9:42 — otmayer 
CARDRIVE_RUN_R DBElement DBElement 6419/98 1:36:59 otmayer 


rf AspectArea / «| 


Close aspect area aa (| (| P| P77 


Figure 3-7. Multiple Windows in Structure Builder 


Administration 


The administration features of Structure Builder are necessary to start-up working in the 


cooperating mode. The administration tool can 
° Create projects 

° Give users access to certain project data 

° Modify passwords 

° Register other Builders and their features 
° Backup and restore project data 


° Delete projects. 


Aspect Request Broker 


During operation the Aspect Request Broker is not visible. It is only interesting for you to 


know that it is a necessary prerequisite for cooperating Builders. 
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3.2 Capacity and Performance 


3.3 Application Start-up 


You can start Structure Builder with command line parameters, which you might use for a 
shortcut of Windows NT. Some of these parameters are optional. With the command line 
parameters you can achieve the following actions: 


° Open a certain project 
° Navigate to a certain Advant object in the pool 
° Navigate to a certain Advant object in a certain structure window. 


Syntax: 


Path [ConnectString ProjectName User Passw [ObjectName NameCategory [StructureName] ] ] 


H:\STI 


Description: 


Path: Path to eob.exe, the Structure Builders’s executable 


Command line parameters for eob.exe: 


ConnectString: The name of the database of Structure Builder; see Project | Open 
dialog in Figure 3-26 


ProjectName: Name of the project you would like to open at start of Structure 
Builder 

User: Username 

Passw: Password 

ObjectName: Name of the Advant object Structure Builder shall navigate to; as an 


Advant Object may have several names, each belonging to a certain 
name category, the name category has to be specified, too. 


NameCategory: One of the available name categories; see Figure 3-60 


StructureName: Name of the structure window that shall be opened; see Figure 3-57 


Parameters which contain blanks have to be enclosed by quotes (“...’”). 


Example for a shortcut: 


B\30r0\bin\eob.exe tns:gitl3_eo Pumpstat rufroehl abc "AI17" "Customer ID" 


"++ Location Structure" 
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See Structure Builder Release Notes for more information. 
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3.4 Tutorial 


See Engineering Methods User’s Guide for more information. 


3.5 Application Procedures 


3.5.1 Design of a Working Environment 


AdvaBuild Engineering Software consists of several products, basic units and options, which 
may again contain several Builders like Structure Builder. Depending on your special needs, 
you may select some or all products. Some of them are mandatory, while others are optional. 
When you want to use the Advant object technology, it is necessary, that you have Structure 
Builder and Advant Engineering Server installed on your system. 


Cooperating Builders must reside on the same PC. This is necessary, because cooperation works 
via the Aspect Request Broker, which works locally on one PC. As the Aspect Request Broker 
is part of the Structure Builder, the Structure Builder is mandatory on each client, because it will 
start all other Builders via the broker. 


On the server PC the server part of Advant Engineering Server and of Structure Builder are 
installed. Beside the Oracle® database it hosts the hard disk area for project data and for the 
network installation of all Builders. To be able to run a certain Builder from a client PC, you 
must start the Setup program from the Netsetup directory of that Builder. The Setup program 
will copy data you need to start the Builder to the hard disk of the client PC. 


To perform this task it is necessary that the client PC and the server PC are connected to a 
network. 


It is possible to install the client and server part of the Builders on one PC. For more information 
about installation, read the Release Notes of Advant Engineering Server. 


You can read about the network environment you need and about software installation in the 
Release Notes of each Builder. 


3.5.2 Show Installed Builders 


You can inspect the currently installed builders with the following command: 
Start | Advant | Engineering | Utilities | Installed Builders 


This will open the window shown in Figure 3-8, which lists the installed builders and their 
version. 
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= Installed Builders ES 


Cancel | 
Help | 


Figure 3-8. Installed Builders 


3.5.3 Project Administration 


The next step after the setup of your environment and software installation is to create a project. 
A project is on one hand a container for engineering data and on the other hand an entity which 
holds access rights of users working with the project data. It is the task of the administrator to 
create a project. 


Project administration is a task with high security demands. Therefore, if you want to administer 
projects, you have to log into the administration utility with a special administrator password. 
As administrator you can create and delete whole projects. Further on you can backup and 
restore projects and adjust the space used for a certain project in the projects’s database. And 
you can modify the passwords of users. 


An user that shall become a member of a certain project, must be assigned to the Windows NT 
group AdvaBuild_engineers. This can be performed with the Windows NT User Manager. 
Members of AdvaBuild_engineers can be assigned by the administrator to a certain project. 
Further on, the administrator can specify whether a project member has read or write access to 
the project data. 


You can start the administration utility with the Project | Administration menu command (see 
Section 3.6.2.3, Administration). 


3.5.4 First Steps After Project Creation 
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When you have created a new project with the Project | Administration menu command, you 
can close the Administration dialog and open the project with the Project | Open menu 
command (see Section 3.6.2.1, Open). When you are logged into the project, the Open 
Structure dialog will be displayed (see Figure 3-9). It lists some predefined structures, which 
are empty at project creation time. 


At this time a first Advant object was created. You can see it, if you open the Pool window in 
the Open Structure dialog. The pool is a list of all Advant objects. Further on you can create a 
Selected Pool window with the View | Filter Objects menu command (see Section 3.7.3.5, 
Filter Objects). The Selected Pool displays a restricted (filtered) subset of Advant objects. If 
you use the default SQL file, you will see all Advant objects in your project. But at this time 
only one Advant object is available. 


3-15 


Structure Builder User’s Guide 
Chapter 3 Configuration/Application Building 


3-16 


Open Structure[s} Eg 
Project: fexp1 310 x] 
Delete | 


Structure: 


- Product Structure 
& Plant Documentation Structue 

+ Mounting Location Structure 

++ Location Structure 

= Function Structure K 
== 0C5-Structure 


: Close 
Project Pool 


Help 


didi 


Figure 3-9. Open Structure Dialog 


This object is the project object. It works as the root object for all other objects of the project. 
The object has three automatically created aspects with the following aspect types: Project 
global data, project pool, and structure. 


Figure 3-10 shows an example of a Selected Pool window for a project named exp13r0 
(Example Project 13r0). In the upper part of the window you see the Object Area. Here the 
Advant objects are shown. The lower part of the window is the so-called Aspect Area, which 
shows the aspects of the selected Advant objects with their attributes. The scope of the aspect 
area is restricted to attributes stored in the aspect registry (see Section 3.1.4, Features of the 
Builders. Structure Builder specific data will be listed in so-called Data Sheets, described in 
Section 3.5.5, How to Work with Structures. 


In the aspect area the three aspects, that are automatically created, are listed. Only a subset of 
the available attributes is shown. 
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Object Area Aspect Area Adjustable Separator 


ia exp1310 (otmayer): Project Pool 


Signal 


| 
p ALARM_1 Signal 


oo MANUAL Signa Pe 
im REFERENCE Signal | al 
Object | Description Type Created Created By Modified Modified By « 
1 Example Project EXP13RO0 Basic Property Basic Property 1149/97 10:37: Start Up 1/7199 16:57 otmayer i 
ie Example Project EXP13R0 Project Global Data Project Global Data = 1119/97 10:37: Start Up 13/7999 13:02 otmayer 
a Example Project EXP13R0 Project OCS Defaults Project OCS Defaults 19/1/97 10:39 eosth 
4 Example Project EXP13R0 Project Pool Structure 119/97 10:37: Start Up 23/8/99 14:09 — otmayer 
es Example Project EXP13RO == OCS-Structure Structure 1911/97 10:44 otmayer 8/26/99 16:44  otmayer 
6 Example Project EXP13R0 ++ Location Structure Structure 191/97 15:06 otmayer 8/26/99 16:44 ~~ otmayer 
7 Example Project EXP13RO0 = Function Structure Structure 191/97 11:19 otmayer 26/8/99 16:43 otmayer 
8 |Example Project EXP1SR0 + Mounting Location Structure Structure 1911/97 16:59 otmayer 8/26/99 16:44 = otmayer = 
4|>[\Aspectarea A —OO~=“‘“SSSSOSSOC(tsti‘“‘isSOSSSS aie 


Figure 3-10. Example of a Selected Pool Window 


The second aspect listed is of type Project Global Data. Only one Advant object can have a 
Project Global Data aspect within a project. Typically this is the project object. The aspect can 
be used to hold some general information about the project. To enter data you must open the Set 
Attributes of Project Global Data dialog. You can do this in two different ways: 


1. Via the Aspect Area: 
a. Select the Project Global Data aspect in the aspect area by clicking a cell of the row. 


b. Click the right mouse button and the Open button that will now appear; now the 
dialog will be displayed (see Figure 3-11). 


2. Via the Object Window: 


a. Double-click in the object area the Advant object that represents the project (in 
Figure 3-10 this object is named Example Project EXP13R0); now the Object 
Window will be displayed. 


b. Select the Project Global Data aspect and click the More | Open button; now the 
dialog will be displayed (see Figure 3-11). 
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Set Attributes of Project Global Data Aspect Ea 


— Customer- 


Name: ji 
Project Name (1): 
: Help 
Project Name (2): 
Project Name (3): 
Factory: | 
District: | 


OK 


Cancel 


hi 


~ Responsible Company — 


Name: SS 
Department: ri 

Project Leader: |. SY 
Revision: i | 

Start Date: fi7.0797142620 00° | 


Figure 3-11. Set Attributes of Project Global Data Aspect Dialog 


You can use the different fields to enter general information about the project. The entered data 
are stored in this aspect only and are not used in other circumstances. 


In the same way you can set attributes of the other aspects. 


Now you have adapted the project object according to your needs. The next step is to create new 
Advant objects. You can perform this with the aid of the Object | New menu command (see 
Section 3.7.1.1, New). This command is available only, if at least pool or a structure window is 
open. The new object will be inserted into the currently active window. 


As a next step you may add aspects you need to the Advant objects. To perform this, double- 
click the object to open the Object Window and click New. Specify the attributes of the aspect 
afterwards. In the Views area of the Object Window you see the available views. Select one 
and click Open to start a Builder that can work on that view. 


AS a project may consist of a huge number of Advant objects, it may be interesting for you to 
design own subsets of Advant objects, called structures. It may be appropriate for example, to 
have certain Advant objects placed in a location structure, while others are available only in a 
control function specific structure. 


You can use the predefined structures and you can define your own structures. To place an 
Advant object into another structure, drag it from the structure where it resides and drop it into 
the destination structure. 


In this manner you can create a hierarchy of Advant objects with several structures. 
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3.5.5 How to Work with Structures 


Object Area 


An Advant object can be placed into one or several structures. To keep track of each structure 
into which an Advant object is inserted, a corresponding structure aspect is added to the Advant 
object. This implies that you do not delete an Advant object when you remove it from a 
structure. In this case you delete the corresponding structure aspect, only. 


While a pool represents a list of Advant objects in arbitrary order, structures offer the possibility 
to define parent-child relations between Advant objects. This makes it possible to navigate in an 
easy way top down through a structure. If you display a structure in compressed form, only the 
Advant objects on the highest level are visible, all children are hidden. 


The children build a subtree to the parent object. It is possible to expand subtree by subtree. This 
mechanism is useful when you try to model real world objects. A rack for example is a 
container for a number of boards, and a board has several channels. Boards and channels are 
subtrees from the structure point of view. 


How to expand and compress structures is explained with the following example (see 
Figure 3-12): 


Project Name UserName _ Structure Name 
Title Bar 


ia exp13r0 [otmayer): ++ Location Structure 


Example Project EXP13R0 Project 
Casting Machine Area Area 
Hydraulic Rooms Area 
Water Distribution Area 
+441.W.F1 Pump Room 1 Room 
HAT WOR Pump Room 2 Room 


Indicator for expanded 
subtree 


. . +441 WARS Pump Room 3 
Indicator for expandible 
subtree f \ 
Icon for Object Type Absolute Reference Object Name Object Type 
Designation (Customer ID 


for example) 
Figure 3-12. Example of the Object Area of a Structure Window 


You can expand or compress a subtree by clicking the indicators (’+’ or ’-’) in front of the 
Advant object. Alternatively you can use the View | Expand (see Section 3.7.3.1, Expand) or 
View | Compress (see Section 3.7.3.3, Compress Subtree) menu commands. 


You can copy single Advant objects or bunches of Advant objects into other structure windows. 
You might be interested for example, to copy the boards and signals to a node control structure, 
but not the racks. As the hierarchy of Advant objects in certain structures is stored in the 
corresponding structure aspects, you may build up completely different structures in different 
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structure windows, if meaningful. The order of Advant objects and also the parent-child 
relations between Advant objects may be different among different structures. 


The picture of a single Advant object as shown in Figure 3-12 consists of a surrounding 
rectangle, an icon, which is specific for a certain object type, and some text fields. The text 
fields that shall be displayed, and the layout of the rectangle can be determined with the 
Options | Project menu command (see Section 3.6.4.1, Project). It is possible for example, to 
display the absolute reference designation behind instead of before the Advant object name, or 
to display the relative reference designation instead. 


Aspect Area 


In Figure 3-12 the object area of the structure window is shown, only. But the structure window 
consists of the object and the aspect area. The aspect area of a structure window looks the same 
as the aspect area of a pool window as shown in Figure 3-10. Between the object and the aspect 
area is the split bar, which can be shifted with the mouse to increase or decrease one of the areas. 
It is possible to hide the aspect area completely (see Section , Split Vertically). This may speed 
up selecting objects in the object area. 


The aspect area hosts a table (see Figure 3-13). A row lists the attributes of a certain aspect. In 
the first column the row number is displayed. The second column hosts the name of the Advant 
object, the aspect belongs to. 


The navigation within the aspect area and how to edit the text of certain cells is described in 
Section A.1, Special Keys for Aspect Area Navigation. 
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unction Structure 

Example Project EXP13R0 Project 

Ladle Tower Process Object 

Tundish Process Object 
CARDRIVE Drive System 

Foy =P2=M1-Q1 CARDRIVE_Motorstarter Control Module 

VE_MCC Binder 

VE_IO Binder 

IVE_Main_Drive Motor 


Signal 


IVE_RUN_L Signal 


=P2=M1=FB_L CARDRIVE_FB_L Signal 
=P2=M1=FB_R CARDRIVE_FB_R Signal 
Casting Machine Process Object 
Torch Cutting Machine Process Object 
Conveyor System Process Object 


Object Description Type Created Created By Modified Modified By 

f CARDRIVE_Main_Drive Basic Property Basic Property 61998 13:36 otmayer l 

2 CARDRIVE_Main_Drive Electrical Device Data —— EI. Device 619/98 13:36 otmayer 

3 CARDRIVE_Main_Drive = Function Structure Structure 61998 13:36 otmayer 8/26/99 16:40 otmayer 

4 CARDRIVE_Main_Drive Project Pool Structure 619/98 13:36 otmayer 8/26/99 16:40 otmayer 

& CARDRIVE_Main_Drive ++ Location Structure = Structure 2/8/99 15:44 — otmayer 8/26/99 16:39  otmayer 
6 CARDRIVE_RUN_R Run Right Basic Property 61998 1:36:59 otmayer 8/23/99 14:31  otmayer 

i CARDRIVE_RUN_R Libray Ref. Basic Property 6/2398 9:42 otmayer 8/23/9914:31_ otmayer 

8 CARDRIVE_RUN_R DBElement DBElement 641998 1:36:59 octmayer 719/9913:41  otmayer 

9 CARDRIVE_RUN_R Electrical Function Data El. Function 6/2199 18:26 otmayer 

10 CARDRIVE_RUN_R SignalParameter Parameter Aspect 6/19/98 1:36:59 otmayer 

11. (CARDRIVE_RUN_R = Function Structure Structure 619/98 1:36:59 otmayer 8/26/99 16:41 otmayer 

12 (CARDRIVE_RUN_R Project Pool Structure 6419/98 1:36:59 otmayer 8/26/99 16:41 otmayer 

13. CARDRIVE_RUN_R == OCS-Structure Structure 6/23/98 9:42 ~— otmayer 8/26/99 16:41 otmayer 

14  CARDRIVE_RUN_L Run Left Basic Property 649/98 13:37 otmayer 8/23/99 14:46 otmayer 

15 CARDRIVE_RUN_L Library Ref. Basic Property 6/23/98 9:42 — otmayer 8/23/99 14:46  otmayer = 
4[>f\Aspectarea # s—<“‘“CO™OS*”*<‘;s‘SOS*”:S”:*C oF 


Figure 3-13. Example of a Structure Window 


A certain cell of the table holds a single attribute of a certain aspect. 


The data that are displayed in the aspect area, depend on the selection in the object area. If you 
change the selection, the data displayed in the aspect area will follow that selection. If you select 
an Advant object, all aspects of that object will be listed in the aspect area, if they are not 
suppressed by a filter. This works for multiple selection of Advant objects, too. The number of 
selected objects is displayed in the first field of the status bar. Therefore, the aspect area offers 
the possibility to visualize aspects of several Advant objects at a time. 


Further on the aspect area allows you to change attributes directly, if possible. For some 
attributes you can edit the text in the cells. To insert or modify text, select the cell and press F2 
or perform a double-click on the cell. Then the cursor will change its form to an I-beam, and you 
can position it where you want to make the changes. If you are done, select another cell to 
terminate the activity. 
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For other attribute types you will get a list box if you position the cursor at a corresponding cell. 
Select a proper value from the list and then select another cell. 


Some other attributes are read-only. 


You can specify which attributes are displayed and in which order with the Format | Column 
Order menu command. Further on you can specify the layout of the table with the aid of the 
commands of the Format menu (see Section 3.8.4, Format Menu). 


You can close the aspect area by moving the adjustable separator between object and aspect 
down to the bottom of the structure window or with the View | Hide Aspect Area menu 
command (see Section , Split Vertically). 


You can save your settings with the Format | Save as Default menu command. These settings 
are stored on your PC and therefore exclusive for you. Other members of the project may use 
other settings. The Format menu is available in the aspect context only. To switch to it, click 
into the aspect area. 


The context menus available for the aspect area are shown in Figure 3-14. With the New 
command you can insert a new aspect. This is only possible, if you have not more than one 
object in the object area selected. These commands can be used as alternative to the menu 
commands available under the Aspect menu. 


To access the context menu, select cells in the aspect area and click the right mouse button. 


Object Description Type Created Created By Modified |Modified By ~ 
4 CARDRIVE_Main_Drive Basic Property Basic Property 6419/98 13:36 otmayer ] 
2 CARDRIVE_Main_Drive Electrical Device Data El. Device 6419/98 13:36 otmayer 
Ss CARDRIVE_Main_Drive |= Function Structure Structure 649/98 13:36 otmayer 8/26/99 16:40 otmayer 
4 CARDRIVE_Main_Drive c Structure 649/98 13:36 otmayer 8/26/99 16:40  otmayer 
5 | CARDRIVE_Main_Drive New. 2/8/99 15:44 = otmayer 8/26/99 16:39  otmayer 
— 6 | CARDRIVE_RUN_R Set Attribute... ty 6419/98 1:36:59 otmayer 8/23/99 14:31 otmayer 
7 |CARDRIVE_RUN_R —_Libray Ref. Attibutes 8/23/99 14:31 otmayer 
_ 8 _CARDRIVE_RUN_R DBElement Structure 719/99 13:41 otmayer 
9 CARDRIVE_RUN_R Electrical Funct Biz > yer 
10 CARDRIVE_RUN_R SignalParameter Parameter Aspect 6/19/98 1:36:59 otmayer 
Figure 3-14. Context Menu for Aspect Area 
Data Sheets 


In addition to the aspect area you can display so-called data sheets. You can open a data sheet 
by selecting a number of aspects (at least two) of the same aspect type (basic property and 
structure aspects), click the right mouse button and then the Open command: then the data sheet 
will be displayed. An example is shown in Figure 3-15. 
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iGw Structure Aspect Datasheet lolx] 


CARDRIVE_Main_Drive 
CARDRIVE_Main_Drive 
CARDRIVE_Main_Drive 


CARDRIVE_READY 
CARDRIVE_READY 
CARDRIVE_READY 
CARDRIVE_RUN_L 
CARDRIVE_RUN_L 
CARDRIVE_RUN_L 
CARDRIVE_RUN_R 
CARDRIVE_RUN_R 
CARDRIVE_RUN_R 


Category Abs. Ref Des. Prefix (Object) Rel.Ref. Des. (Object), Ref.Des.Control 
= Function Structure = =P2.M1-M1 - M1 [ 
Project Pool 
++ Location Structure = ++41.T 
= Function Structure = =P2.M1.READY = READY 
Project Pool 
== OCS-Structure ==M1 .C2.D1800_1.1 
= Function Structure = ==P2.M1.RUN_L = RUN_L 
Project Pool 
== OCS-Structure ==N1.C2.DO800_2.2 
Project Pool 
= Function Structure } =P2.M1.RUN_R = RUN_R 
== OCS-Structure ==N1.C2.D0800_2.1 


4|>f\ Datasheet (7™—”—~<“Cs~=“‘sS~SS wf 


Figure 3-15. Example of a Data Sheet 


A data sheet looks similar to an aspect area. The difference is that it holds another category of 
data: while an aspect area holds registered data, that are administered by the Aspect Request 
Broker, a data sheet lists aspect attributes that are private for the Structure Builder. The handling 
of data sheets is the same as for aspect areas. For data sheets you can save your layout settings in 
the same way as for aspect areas with the Format | Save as Default menu command (see 
Section 3.8.4.8, Save as Default). 


Display Differences 


If you add an Advant object in a certain structure while you have a pool window open, the pool 
window will not be updated. But modifications of attributes or deletion of Advant objects 
performed in structure windows will be shown in the pool window, too. 


Copying Hierarchies of Advant Objects 

For copying Advant objects two different methods are available: 
° Drag and drop 

° Copy and paste. 


In both cases all child objects are copied together with their parent objects. It is not necessary to 
expand and select the whole subtree before copying. 


The behavior to copy objects together with their whole subtree will be consecutively applied to 
each selected object. This may lead to a duplication of subtrees depending on the actual 
selection. This is explained with the example shown in Figure 3-16: 


3BSE 013 932R201 


3-23 


Structure Builder User’s Guide 
Chapter 3 Configuration/Application Building 


<» pumpstat (rufroehl): ++ Location Structure 


a. PumpStat 


Copy and Paste 


= 19 19 
Flow Sensor 4 


ica pumpstat (rufroehl): = Function Structure 


fab Rack23 RT 
Gr AlBoard2 A IeAi2 aia | 

WEF AlBoad2 +2 a2 

[MD Rack2a R22 


Figure 3-16. Copy Behavior Including Whole Subtrees 


Three Advant objects are selected in the ++Location Structure and shall be copied into the 
empty =Function Structure via copy and paste. At first Rack 23 will be copied with all its 
children. The action results in Rack 23 and AI Board 2 as child of Rack 23. The next selected 
object is AI Board 2. This object again will be copied with its children. The same applies to the 
third selected object. All three objects will be inserted at the same level in the structure 
hierarchy, the one you have selected before you issued the Paste menu command. 


Notice, that the absolute reference designations of AI Board 2 in the =Function Structure are 
different. The objects’s absolute reference designation is displayed in the middle of the object’s 
rectangle, while the relative reference designations is placed at the right side. 


If you don’t want to duplicate AI Board 2, deselect it the ++Location Structure or compress 
Rack 23 before you select Rack 23 and Rack 24. 


Copy Selected Objects Only (Copy/Paste Without Subtree) 


If you only want to copy the selected objects without their subtrees, you can perform one of 
following alternatives: 


° Drag and drop: 
Drag the objects you want to copy, but click the right mouse button instead of the left one 
while dragging, drop them to the destination and release the right mouse button there. 
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Then the following context menu will be displayed: 


Paste 
Move 
Place 


Paste Without Subtree 
Place Without Subtree 


Cancel 


Figure 3-17. Context Menu for Drag and Drop 


— Select Paste, Move, or Place if you want to copy, move, or place the selected Advant 
object together with it’s children at the destination 


— Select Paste Without Subtree or Place Without Subtree if you want to copy the 
parent object only. Moving of the parent object only is not possible. 


- Select Cancel to terminate the command. 


° Copy and paste: 
When you have copied the selected Advant objects with the Edit | Copy menu command 
to the clip board, use the Edit | Paste Without Subtree menu command to copy the 
selected objects only. 


In both cases the selected objects will be copied without subtrees. This situation is illustrated 
with Figure 3-18 and Figure 3-19: If you have copied the selection shown in Figure 3-18 with 
the Edit | Copy menu command to the clip board, a consecutive Edit | Paste Without Subtree 
menu command will insert the following Advant objects at the destination: Rack 23, AI Board 
2, and Rack 24. The Without Subtree attribute suppresses insertion of the child objects of AI 
Board 2, as shown in Figure 3-19. 


Psa pumpstat (rufroehl): ++ Location Structure 
FP PumpStat 
= 


a iiiil Ri 


EVP alsigna45 SS 


Figure 3-18. Illustration of Paste Without Subtree Behavior - Source 
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iG pumpstat (rufroehl): Library Structure 


=) fi) Rack 23 Ril 
REE Al Board 2 Ale 
i Rack 24 R2 


Figure 3-19. Illustration of Paste Without Subtree Behavior - Destination 


Move, Place, Copy Differences 


Within Structure Builder three methods to handle Advant objects between structures or within a 
structure are available: move, place, and copy. 


When you move an object, it will be taken from the position where it resides and will be put to 
another location. After a move operation the object will not reside at its original position 
anymore. 


When you copy an object, a new object will be created at the new location. The original object 
will still reside at the original location. 


When you place an object, the same object occurs multiply. If you modify the placed object, you 
will see the modifications at all locations where it occurs. 


3.5.6 Object Selection Techniques 


3.5.6.1 Mouse Selection 
You can use two kinds of object selections: 
° Single object selection: 
Point at an Advant object and click once with the left mouse button. 
° Multiple object selection: 


By multiple object selection you can select more than one object at the same time. 
Multiple selection is further classified as 


— Continuous selection (range selection) 
—  Disjoint selection (selected objects are separated by non-selected objects). 
You can combine continuous selection and disjoint selection. 


Selected objects are highlighted. 
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You can operate on a selected object, for example copy it, move it, or delete it. The Structure 
Builder follows an object-action model: select the object(s) you want to operate on always at 
first and then the function you want to execute. 


To deselect all your objects just click on an arbitrary object. 


To deselect single objects see Disjoint Selection in this section. 


Context Menus 


For selected entities - Advant objects in the object area or aspects in the aspect area - context 
menus will pop, if you click the right mouse button somewhere in the Structure Builder’s 
window. From this context menu you can select a command by clicking the command with the 
left mouse button. An example of a context menu for a selected Advant object is shown in 
Figure 3-20. 


ig@ exp1310 (otmayer): = Function Structure 


Example Project EXP13R0 Project 


Ladle Tower Process Object 


Tundish Process Object 


CARDRIVE Drive System 


ia CARDRIVE_MCC 


ia CARDRIVE_IO 


CARDRIVE_Main_Drive 


{ p =RUN_A CARDRIVE_RUN_R Remove From Structure Context Menu 


[ p = RUN_L CARDRIVE_RUN_L Delete 


[ p = READY CARDRIVE_READY 


[ p =FB_L CARDRIVE_FB_L 


[ p =FB_R CARDRIVE_FB_R 


Casting Machine Pro 


Torch Cutting Machine Pro 
Conveyor System 


Figure 3-20. Context Menu for the Selected Advant Object 
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1c 


ra 


Torch Cutting Machine 
Conveyor System 


ry Example Project EXP13R0 
po LadleTower 


a. Ladle Tower 


Continuous Selection 


Select the object where you want to start the selection. Hold down the Shift key and then select 
the object by which you will enclose your continuous selection. Only the displayed objects are 
selected, objects of hidden subtrees are not selected. 


unction Structure 


Mould Level Control 


Durmy Bar Handling 


Strand Drive System 


Roller Cooling System 
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Spray Cooling System 


Spray Cooling Zone 1 
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___ 1. Select 
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Control Valve 


Valve_Open 


3. Result 


Valve_Closed 
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Spray Cooling Zone 2 


Flow Control Z2 


Flow Sensor 


Signal Transmitter 
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Controller_Output 


Signal Transmitter 


Control Valve 
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Valve_Closed 


& 
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ica exp131r0 (otmayer): = Function Structure 


‘a Example Project EXP13R0 


Ladle Tower 
#4) ad Tundish 
=) a Casting Machine 
Mould Level Control 


Dummy Bar Handling 


Strand Drive System 


Roller Cooling System 


Spray Cooling System 


Spray Cooling Zone 1 


P2_Pressure 


Spray Cooling Zone 3 


Spray Cooling Zone 4 
PUMPDRIVE 
Torch Cutting Machine } 


‘a Conveyor System 


Figure 3-21. Continuous Selection of Objects 
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Disjoint Selection 


Disjoint selection requires to hold down the CTRL key when you select an object. See 
Figure 3-22. 


ig@ exp13r0 (otmayer): = Function Structure 


[BP _Example Project EXP13R0_| 
a Ladle Tower 

Do Tundish 
[P___CastingMachine __| 


-ontrol 
a 
a 


(+) 


select ome 
umm Handling 


Cl 

4 
a. Strand Drive System 
‘a Roller Cooling System 


select while 
holding down the Ctrl key 


ne 
a Spray Cooling Zone 3 


ad Spray Cooling Zone 4 
‘a PUMPDRIVE 


Figure 3-22. Disjoint Selection of Objects 


To deselect all your objects just click on an arbitrary object. 
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To deselect single objects just select the object again holding down the Ctrl Key 


ig@ exp1 310 (otmayer): = Function Structure BEE 
Example Project EXP13R0_ | 


[ p Ladle Tower 
Po Ttundsh 


select here while 
holding down the Ctrl key 


[ p Torch Cutting Machine 


+ A Conveyor System 


Figure 3-23. Deselection of Single Objects 


NOTE 


If you have several windows open and you choose any menu item representing a 
command to be performed on selected Advant objects, for example copy, move, 
or delete, those commands will only be performed on the selected Advant objects 
in the currently active window. 


3.5.7 Techniques for Graphical Manipulation of Data 


3.5.7.1 Drag and Drop 


You can use drag and drop — as an efficient way to graphically manipulate your data — to place, 
move and copy Advant objects. Just grab a required object and position it, drag it to a new 
location either to place it in a new structure, to move it from its old position to a new one, or to 
copy the object. 


To position an object at a new location in a structure you release it (drop it) at a certain target 
object 


° Inside the object frame to insert it as first child of the target object. The cursor gets one of 
the following images, depending on the activity, move, place or copy. 


|__| 
J co pee 
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° Right hand outside the target object to insert it below the target object on same level. The 
cursor gets an image like the one shown below, but possibly with another activity indicator 
(‘=’ or blank). 


|__| 
CEI 
° Left hand outside the target object to insert it above the target object on same level. The 
cursor gets an image like the one shown below, but possibly with another activity indicator 
(‘=’ or blank). 
== 
= 


If you are dragging two or more objects the cursor image will indicate this as shown in the 
example below: 
——! 


realy 


If you drop it in the empty part of the structure window it will be inserted as root object. 


To drag an object, point at it, hold down the left mouse button and then position the mouse 
pointer over the required target object. While dragging, the mouse pointer indicates if you are 
dragging one ore more objects. 


To drop an object at the target object, release the left mouse button. 


Table 3-1 gives an overview of functions which are available via drag and drop: 


To | Same Project Different Project 
(Selected) Pool | Project Structure (Selected) Pool Project Structure 

From (arbitrary) (arbitrary) 
(Selected) Pool copy copy copy copy 

place 
Project Structure | copy move copy copy 

copy 

place 


Table 3-1. Drag and Drop Functions 
Symbols presented while dragging: 
= (equal sign) for placing 
+ (plus sign) for copying 


no additional sign (blank) for moving. 


3BSE 013 932R201 3-31 


Structure Builder User’s Guide 
Chapter 3 Configuration/Application Building 


3.5.8 Special Key and Mouse Button Bindings 


Mouse Button Assignment 


Action with Left Mouse Button | Function 


Single Click Object selection (dependent on selection 


mode) 


Double Click Open the Object Window 


Table 3-2. Mouse Button Assignment 


Modifier Keys 
Modifier keys for drag and drop (have to be hold down while dragging and dropping): 


Function: Modifier Key: 
Move Alt 
Copy Ctrl 
Place Shift 


Table 3-3. Modifier Keys 


Drag and Drop Defaults (no modifier key pressed) 


To | Same Project Different Project 
From (Selected) Pool | Project Structure | (Selected) Pool Project Structure 
(Selected) Pool place copy copy 
Project Structure | copy move'") copy copy 
place) 


Table 3-4. Drag and Drop Defaults 


(1) different structure 
(2) same structure 
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3.5.9 Inserting/Deleting Advant Objects 


3.5.9.1 Copying Advant Objects in the Selected Pool 


You can copy Advant objects in the selected pool. 


When you copy an object, a new object is created in the selected pool. 


Copying by Using Menu Items 

1. Select the object you want to copy. 

2. Choose Copy in the Edit menu. 

3. Select the object where you want to place the copy. 
4. Choose Paste in the Edit menu. 


The object is copied with its aspects (except structure aspects) and placed below the selected 
target object. 


If you want to copy an object but to exclude one or several aspects from being copied, then 
choose Paste Special from the Edit menu. The Paste Special dialog appears in which you can 
deselect aspects. You can also select how the copy shall be placed in relation to the target object 
(as child, below or above the target object). 


Copying by Using Drag and Drop 


To copy an object inside the pool you drag it to a target object in the pool and drop it there. 
While dragging hold down the Ctrl key. 


3.5.9.2 Deleting Advant Objects in the Selected Pool 


You can delete an Advant object in the pool. 

When you have placed this object in one or more of your structures it will be removed there. 
To delete an object select it and choose Delete in the Object menu. 

Shortcut: BackSpace or Del key. 


You can also select multiple objects for deleting. 


3.5.9.3 Placing Advant Objects into Structures 


To give an object a certain location in one of your structures you have to place it. When you 
place an object you do not create a new object. The number of objects in the pool remains 
constant. The object gets an additional structure aspect containing the information about the 
new structure position. 


You can place an object in one or more structures. 


You can place an object in the same structure one or several times. 
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Placing an Object Using Menu Items 


1. 
2: 
3. 


Ph Oyo Ou or 


8. 


Select the object(s) to be placed. 
Choose Copy from the Edit menu. 


Select the object to which selected object(s) 
shall be placed. 


Choose Paste Special in the Edit menu. 
The Paste Special dialog appears. 


Select Action Place. 


Select one of the placing relations to the target object: 


As Child / Above - / Below - On Same Level. 
Click OK. 


The object is placed on the selected position. 
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Placing an Object Using Menu Items 


xp13r0 (otmayer): + Mounting Location Structure 


= Pl Ladle Tower Process Object + 


Tundish Process Object 
CARDRIVE Drive System ] + ECO3 MC Cabinet ECO3 
VE_Motorstarter Control Module ad + 101 MC Location 1 
CARDRIVE_MCC Binder ic} ad + 114 MC Location 2 
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RUN_L CARDAIVE_RUN_L Signal MC Location 6 
READY CARDRIVE_READY Signal Instrumentation Cabinets Cabinet ] 
FB_L CARDRIVE_FB_L Signal Junction Boxes Constructional t] 
FB_R CARDRIVE_FB_R Signal Marshalling Racks Constructional y 
Casting Machine Process Object] Control Desks Constructional q 
Torch Cutting Machine _ Process Object] Control Pulpits Constructional |] 
Conveyor System Process Object Ausiliary Mounting Structure ystem ] 


Selected object in the function structure 
to be placed in the mounting location structure 


*xp13r0 (otmayer): + Mounting Location Structure BEE 


‘me Example Project EXP13R0 Project 
Object in the mounting location structure (6 OCS Mounting Locations Cabinet 
to which selected object shall be placed as child [_______-MCMounting Locations Cabinet | 


(ff + EC03 MC Cabinet ECO3 Cabinet ] 
MC Location 1 Slot 
MC Location 2 Slot 
MC Location 3 Slot 
MC Location 4 Slot 


Placed Object 


MC Location 5 Slot 
MC Location 6 Slot 


Instrumentation Cabinets Cabinet ] 


Junction Boxes Constructional |] 
Marshalling Racks Constructional |] 
Control Desks Constructional |] 
Control Pulpits Constructional [ 


Ausiliary Mounting Structures ystem 


Figure 3-24. Placing an Object 


3BSE 013 932R201 3-35 


Structure Builder User’s Guide 
Chapter 3 Configuration/Application Building 


Placing by Drag and Drop 


To place an object you can drag it either from the selected pool or from a structure where it 
already has been placed in and drop it on a target object. 


The dragged object is positioned as first child of the target object. It can be re-positioned via a 
Move operation. 


If you drop the dragged object just on an empty space in one of your structure windows (not 
occupied by an other object) it is inserted as object on root level. 


If you drop the dragged object left hand outside the target object frame it is placed above the 
target object on same level. 


If you drop the dragged object right hand outside the target object frame it is placed below the 
target object on same level. 


You can select multiple objects for placing with or without subtrees. 


3.5.9.4 Copying Advant Objects in/into Structures 


3-36 


You can copy and place objects within a structure and between structures. 
Multiple selection is possible. 
The selected pool will contain the new objects. 


Copying Advant Objects by Using Menu Items 

1. Select the object(s) you want to copy. 

2. Choose Copy in the Edit menu. 

3. Select the target object which shall become parent of the copy/copies. 
4. Choose Paste or Paste Without Subtree in the Edit menu. 


The object is copied with its aspects (except structure aspects) and placed as child to the 
selected target object. 


If you want to copy an object but to exclude one or several aspect types from being copied then 
choose Paste Special from the Edit menu. The Paste Special dialog appears in which you can 
deselect aspects. By using Paste Special you can also place the copy above or below the target 
object on same level. 


1. Select object(s) to be copied. 

Choose Copy in the Edit menu. 

Select target object to which the copies of the selected object(s) shall be placed. 
Choose Paste Special in the Edit menu. 

The Paste Special dialog appears. 

Select Action Copy and uncheck the field With Subtree. 


polit NONLIN ee > fe Bo 


Select one of the placing relations to the target object: 
As Child / Above - / Below - On Same Level 


8. Click on OK. 
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Copying Advant Objects by Drag and Drop 


To copy an object you drag it from its position in one of your structures or from the pool and 
drop it on the target object. While dragging hold down the Ctrl key. 


The copy is inserted as first child of the target object. It can be re-positioned via Move. 


If you drop the dragged object just on an empty space in one of your structure windows (not 
occupied by an other object) it is inserted as object on root level. 


If you drop the dragged object left hand outside the target object frame it is copied above the 
target object on same level. 


If you drop the dragged object right hand outside the target object frame it is copied below the 
target object on same level. 


You can select multiple objects for copying with or without subtrees. If you drag the objects 
with the left mouse button clicked, the objects are copied with subtrees. If you drag them with 
the right mouse button clicked, a menu pops up and you can select whether copying shall be 
performed with or without subtrees. 


The name of the source object is also copied, therefore the copy must be renamed. 


3.5.9.5 Moving Advant Objects in Structures 


3BSE 013 932R201 


To change the location of an object in one of your structures you can move it to an other 
location in the same or another structure. If the object to be moved is parent of a subtree you 
should always move the complete subtree. 


Moving Advant Objects by Using Menu Items 
1. Select object(s) to be moved. 


2. Choose Cut in the Edit menu (the object(s) remain in the structure until you choose Paste 
from the Edit menu)). 


3. Select object which shall become parent of the moved objects. 
4. Choose Paste from the Edit menu. 


The object is moved and placed as child to the selected target object. 


Moving by Drag and Drop 


To move an object you drag it from its position in one of your structures or the pool and drop it 
on the target object. While dragging hold down the ALT key. 


The moved object is placed as first child of the target object. 


If you drop the dragged object just on an empty space in one of your structure windows (not 
occupied by an other object) it is placed as object on root level. 


If you drop the dragged object left hand outside the target object frame it is placed above the 
target object on same level. 


If you drop the dragged object right hand outside the target object frame it is placed below the 
target object on same level. 
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You can select multiple objects for moving. If the object to be moved is parent of a subtree you 
should always move the complete subtree. 


3.5.9.6 Removing Advant Objects from Structures 


You can remove Advant objects from a structure position. If the object is placed in several 
structure positions the object will only be removed from the position where it is selected. The 
structure aspect of the object which indicates the position from where the object was removed is 
deleted. 


Removing of an Advant object is only possible, if it has no child objects. If it has child objects, 
remove these objects at first. 


To remove an object from a structure position: 
1. Select the object. 


2. Choose Remove From Structure in the Object menu. 


3.5.9.7 Deleting Advant Objects 


You can select the Advant object to be deleted either in the selected pool or in a structure. If you 
delete the object it will be removed from all structure positions and from the selected pool. 


Deleting of an Advant object is also possible, if it has child objects. 
To delete an Advant object: 
1. Select the object. 


2. Choose Delete in the Object menu. 


3.5.9.8 Renaming Advant Objects 


You can rename Advant objects. The object(s) to be renamed can be selected either in the 
selected pool or in one of the structures. 


To rename an Advant object: 

1. Select the object(s). 

2. Choose Rename in the Object menu. 
3. The Rename Object dialog appears. 
4 


Fill in the new object name into the Name field or use Substitute Fields to substitute parts 
of the old name(s). 


5. Click on OK. 
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3.5.9.9 Deleting Structures 


You can delete an empty structure. Before deleting it, use the Object | Remove from Structure 
menu command to remove all Advant objects from the structure. 


To delete a structure: 


1. Choose Structure in the Window menu. 
2. The Open Structure dialog appears. 

3. Select the structure to be deleted. 

4. Click Delete. 


3.5.9.10 Inserting Reference Designations 


CARDRIVE_Main_Drive 
CARDRIVE_Main_Drive 
CARDRIVE_RUN_R 
CARDRIVE_RUN_R 
CARDRIVE_RUN_R 
CARDRIVE_RUN_L 
CARDRIVE_RUN_L 
CARDRIVE_RUN_L 
CARDRIVE_READY 
CARDRIVE_READY 
CARDRIVE_READY 


4|>]\ Datasheet _/ Nel | 


You can assign to Advant objects in structures a relative reference designation. The relative 
reference designation designates the Advant object in the structure unambiguously (not checked 
by the system) with respect to its parent object. 


To insert the relative reference designation, double-click an Advant object in the selected 
structure window to open the object window, select the corresponding structure aspect and open 
the attributes view. Now the Set Attributes of Structure Aspect (see Figure 3-86) dialog is 
displayed, where you can specify the reference designation. 


An alternative way to insert reference designation is given by the datasheet of several structure 
aspects. How to open a datasheet is explained with the help of Figure 3-13: In the aspect area 
select all structure aspects of the selected objects. This can easily be done with the View | Filter 
Aspects menu command. Then issue the More | Open | Attributes menu command via the 
Aspect menu or by clicking the right mouse button to get the context menu. Then you will get a 
datasheet as shown in Figure 3-25. You can edit the reference designations directly in the 
datasheet. 


gw Structure Aspect Datasheet | — (OL x! 


Abs Ret.Des. Prefix (Object) Rel.Ref.Des. (Object) |Ref.Des.Control Category 

=P2.M1 -M1 - M1 > = Function Structure [ - 
Project Pool 

++41.T ++ Location Structure 
Project Pool 

=P2.M1 RUN_R = RUN_R = Function Structure 

==N1.C2.D0800_2.1 == OCS-Structure 

=P2.M1 .RUN_L = RUN_L = Function Structure 
Project Pool 

==N1.C2.DO800_2.2 == OCS-Structure 

=P2.M1 READY = READY = Function Structure 


Project Pool 
== OCS-Structure 


==N1 C2 DI800_1.1 
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Figure 3-25. Structure Aspect Datasheet 
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It is distinguished between relative and absolute reference designations. A relative designation 
is given to a certain object and is meant relative to the object’s parent object. An absolute 
designation refers to the root of a structure. Usually, absolute designations will be build by 
concatenating all relative reference designations from the root object down to the dedicated 
object. In a concatenated designations, you can specify whether a separator shall be inserted 
between the relative designations or not. 


An example is shown in Figure 3-12: The object Pump Room | has an absolute reference 
designation ++A1.W.R1. The prefix indicates that this is a location, while dots are used as 
separators between the relative reference designations. 


You can specify with control elements the use of reference designations: You can specify that 
° At a certain level concatenation of designations shall stop, or that 
° At a certain level a new origin for another absolute designation shall be defined. 


It is also possible to insert reference designations for aspects. You can specify them in the 
Object Window. Select an aspect and click Edit to insert a designation or a prefix. 
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3.6 Configuration/Application Building Menus; Project Context 


3.6.1 Introduction 


The description of menus of Structure Builder is structured on top level according to the context. 
When you work with Structure Builder the application can stay in three different states or 
contexts: Project, Object and Aspect. Depending on its context, Project, Object, or Aspect is 
the name of the left-most menu of Structure Builder’s menu bar. When you start the application, 
it is in the Project context, because the main tasks you might perform now is project 
administration or opening a project. When working in another context, the Project menu is still 
there, but at another position in the menu bar, shifted to the right. 


Depending on where you click in a structure window, into the object area or the aspect area, the 
menu bar of Structure Builder adapts to the possible tasks in this context, Object or Aspect. 


Therefore context means, that the menu bar will context-sensitively change when you a going to 
perform certain activities that are project, object, or aspect related. 


3.6.2 Project Menu 


3.6.2.1 Open 


Use the Project | Open menu command to open an existing project. Then the following dialog 
is displayed: 


Open Project Ea 


Database: ftns:citt 289 _e0 ¥ 
Project: fexp130 7] (ceoet | 
User: Jotmayer Hel | 
7% Help 
Password: [ 


Figure 3-26. Open Project Dialog 


Enter the required data and click OK. Now you will be logged into the database for the selected 
project. As alternative you may use the Project | Recent Project List menu command to open a 
project you have worked with recently (see Section 3.6.2.7, Recent Project List). The entry 
fields for Database and Project consist of drop-down list boxes, which store the earlier used 
entries. As this information is stored on your client PC, it may be that this information is not 
valid anymore. To remove entries from the list box, use the Delete button in the dialog of the 
Options | Project menu command (see Section 3.6.4.1, Project). 


It is possible to open more than one project. If you want to open another project, use the 
Project | Open command again. 
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If you are going to open a project made with a version of Structure Builder older than the 
current one, a message box will inform you about that and you can open the Upgrade Dialog 
(see Section 3.6.2.4, Upgrade). 


Dialog Controls 


Database 
You can enter a database name. The database name was specified during the installation of 
Structure Builder. You can work with one database at a time and on one database server. 


Project 
Enter the project name. A project can be created with the Project | Administration menu 
command (see Section 3.6.2.3, Administration). 


User Name 

Enter your user name. To be able to open the project, your name must be assigned to the project 
by your administrator. This can be performed with the Project | Administration menu 
command (see Section 3.6.2.3, Administration). 


Password 
Enter your password for logging into the project’s database. 


After clicking OK the Open Structure(s) dialog will be displayed. Here you can select one or 
more structures you want to work with. 


Open Structure[s]} EG 
Project: exp1 310 v 
Structure: Add... Delete | 


& Plant Documentation Structue 
+ Mounting Location Structure 
++ Location Structure 

= Function Structure 


== 0C5-Structure 
Library Structure 
Project Pool 


Figure 3-27. Open Structure Dialog 


This dialog is explained in Section 3.6.5.1, Structure. When you click OK, the corresponding 
structure window(s) will be displayed. 
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Object Area 


exp1310 (otmayer): = Function Structure 


[ p Example Project EXP13R0 — Project 


=P1 Ladle Tower Process Object 


CARDRIVE Drive System 
=P2=M1-01 CARDRIVE_Motorstarter Control Module 
=P2=M1 CARDRIVE_MCC Binder 


ia =P2=M1 CARDRIVE_IO Binder 


k ‘M1 in_ Dri Motor 


=P2=M1=RUN_L  CARDRIVE_RUN_L Signal 
=P2=M1=READY — CARDRIVE_READY Signal 
=P2=M1=FB_L CARDRIVE_FB_L Signal 
=P2=M1=FB_R CARDRIVE_FB_R Signal 
=P3 Casting Machine Process Object 
=P4 Torch Cutting Machine Process Object 
Conveyor System Process Object 


Description | Type Created Created By = Modified Modified By 

‘CARDRIVE_RUN_R Run Right Basic Property 619/98 1:36:59 PM otmayer 8/23/99 14:31 otmayer 
CARDRIVE_RUN_R Libray Ref. Basic Property 23/698 9:42 otmayer 23/8/99 14:31 otmayer 
CARDRIVE_RUN_R DBElemert DBElement 619/98 1:36:59 PM otmayer = 7/19/99 13:41 otmayer 
CARDRIVE_RUN_R Electrical Function Data El. Function 21/6/99 18:26 otmayer 

CARDRIVE_RUN_R SignalParameter Parameter Aspect 6/19/98 1:36:59 PM otmayer 

CARDRIVE_RUN_R = Function Structure = Structure 619498 1:36:59 PM otmayer 8/26/99 16:41 otmayer 
CARDRIVE_RUN_R Project Pool Structure 619/98 1:36:59 PM otmayer 8/26/99 16:41 otmayer 
CARDRIVE_RUN_R == OCS-Structure Structure 6/23/98 9:42 otmayer 8/26/99 16:41 otmayer 


» fy AspectArea / 


Aspect Area adjustable separator 
Figure 3-28. Structure Window 


The structure window is split into two areas: an object area (upper part of Figure 3-28) and an 
aspect area (lower part of Figure 3-28). The object area shows a structural view of the Advant 
objects belonging to the selected structure. The aspect area shows all aspects of the Advant 
objects which are selected in the object area. How to work with the structure window is 
described in Section 3.5.5, How to Work with Structures. 


As it is possible to work with several projects simultaneously and to keep several structure 
windows open, the title bar of each structure window lists the user name, the project name, and 
the structure name. In Figure 3-28 user name is otmayer, project name is exp134r0, and 
structure name is =Function Structure. 
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3.6.2.2 Close 


Use the Project | Close command to close a project. Then the following dialog is displayed: 


Close Project Ea 


Project: 


Figure 3-29. Close Project Dialog 


From the Project list box select the project you want to close and click OK. You can select one 
project at a time. When you close a project, you will be logged off the database for that project. 
When you exit Structure Builder all open projects will be closed automatically. 


3.6.2.3 Administration 


Under Administration all features to administer projects, users, and user rights are put together. 
The administration task is normally assigned to a system administrator. Therefore, for security 
reasons, you have to log into the administration part with an administrator password. 


NOTE 


It is recommended, that no others users are connected to the server database while 
the administrator is working. 

Use the Project | Administration menu command to 

° Administer users 

° Administer projects and 

° Assign users to projects. 


Then at first the Logon dialog is displayed: 
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Administrator Logon Eg 
Database: [tns:aitt 392_e0 


~ Authentication | Cancel | 


User Name: eostb 
Help | 
Password: I 


Figure 3-30. Administrator Logon Dialog 


Enter the connect string for the database you want to administer and enter your administrator 
password. The user name is predefined and cannot be changed. 


You can change the administrator password in the following way: 


1. Via the Windows NT Start folder select Programs / Oracle for Windows NT / SQL 
Plus 


The following dialog will be displayed: 


User Name: eosth 
Password: 
Host String: [tns:gitl 392_e0 


=e 


Figure 3-31. Logon Dialog for SQL Plus 
Enter the name of the database (User Name: eostb), the password, and the connect string 
to your database. 


2. The SQL Plus window will be displayed. At the SQL> prompt enter the following line: 
alter user eostb identified by <new_password>; <ENTER> 
exit<ENTER> 


Now the new password is valid. 


After completing the logon process the Project Administration dialog will be displayed: 
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Project Administration Ea 


Database: tns:gitl289_eo 


— Database Users 


elel Delete | Change Pwd... | 


@ Available ™ New 


eouserl 
eouserl1 
hehauck 
otmayer 


Projects 


Add... | Delete | Expand... | Besister...| 


Back-up... | 


@ Available  Backed-up 


-User to Project Assignments - 


User 
anagraefe 
eouserl 
eouser]1 
eouserl1 
hehauck 
hehauck 
otmayer 
otmayer 
otmayer 
otmayer 


Add... | Delete | Change | 


Project Access Right 
testprol write 

testprol write 

expl2r1 write 

testpro1 write 

lib12r0 write 

testprol write 

exp 2r1 write 

expl2r3 write 

exp130 write 
exp13r01 write hal 


ne | 


Figure 3-32. Project Administration Dialog 


The dialog is separated into three areas: Users, Projects, and User to Project Assignments. 


At the top of the dialog the database connect string of the database, you are currently connected 
to, is shown. One database connection at a time is possible, only. 


When opening the dialog, the users that are already assigned to the database are listed. These 
users can be assigned in a further step to different projects of that database. When you want to 
add a certain user to the database, click the New button. The Users list box displays now all 
users that are members of the Windows NT group AdvaBuild_engineers, that are not mapped 


to this database. 


Additionally you can delete a user from the database and change the password of a certain user. 
If you delete a user, he/she will implicitly be deleted from all projects within the database, 


he/she was assigned to. 
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The Projects area shows the projects that are stored in the database you are connected to. 
You can 


° Add a new project 

° Delete an existing project from the database (while the Available button is selected) 

° Delete an backed-up project from the file system (while the Backed-up button is selected) 
° Expand the size of a database 

° Register new Builders 

° Back-up whole projects 

° Restore whole projects 

° Display a summary of the space, that is used by the projects of the database. 


The User to Project Assignments area lists the projects and the access rights mapped to a 
certain user. The list can be sorted according to users, projects, or access rights by clicking in 
the corresponding part of the title of the list 


Users Area Controls 


Add 

The Add button is only active if the New button is selected. Then all users, that are known by 
the system, but not mapped to the database you are connected to, are listed. Click Add to add a 
selected user to the database. Afterwards this user will be listed in the list box when the 
Available button is selected. After clicking Add the following dialog will be displayed: 


Add User Ea 


User Name: mowendla 


Password: ; SY 
Cancel | Help | 


Figure 3-33. Add User Dialog 


Enter a password for the selected user. This password the user will need when he/she wants to 
log into a project. 


Delete 
Click Delete if you want to delete selected users from the current database. No user password is 
required. 


Change Pwd 
Click Change Pwd to change the password of a selected user. Then the following dialog is 
displayed: 
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Change Password Ea 


User Name: mowendla 


Password: [ 
Cancel | Help | 


Figure 3-34. Change Password Dialog 


Enter a password for the selected user and click OK. 


Projects Area Controls 


Add 
The Add button is only active if the Available button is selected. Then all projects of the 
database are listed. Click Add to create a new project. Then the following dialog is displayed: 


Add Project Eg 
Project Name: [PumpStat 


; Database 
Edt... | Shece 
Components: Sizes (MB): Resources: Free (MB): 
\\qitl 392\.advabld1 53 
STB 5 
+ File System 


Space 
Resources: Free (MB): 
\Naitl 392\.advabld1 53 


OK | Apply | Cancel | Help | 


Figure 3-35. Add Projects Dialog 
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The project’s data are stored in a database and in the file system. While you can store data in 
files as long as the hard disk is not completely full, you have to specify for the database, how 
much space it shall reserve for your projects. 


The different Builders of the AdvaBuild Engineering Software use two different Oracle 
databases. One is referred to as CAEE database, which holds data of the electrical CAD tools of 
the selected project. The other is referred to as STB database which holds the data of Structure 
Builder of the selected project. 


In the database area you can specify the hard disk space used for both databases. 


Dialog Controls of Add Projects Dialog 


Project Name 

Enter a valid project name. A project name may consist of maximal eight characters. The first 
character has to be a letter, followed by seven alphanumeric characters. The only allowed 
special character is the underscore (’_’). 


Database 


Sizes 
The initial size of the databases of the selected project is displayed in MBytes. Click Edit 
or double-click the line to modify the size. Then the following dialog will be displayed: 


Edit Size Ea 


Component: STB 


Size (MBytes): [5 
| Cancel | 


Figure 3-36. Edit Size Dialog 


Enter the new size and click OK. 


Resources 
Under Resources the share name of the directory where the project data are stored is 
displayed. 


Space Free 
The free memory on the hard disk is listed. 
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File System 


Resources 
Under Resources the share name of the directory where the project data are stored is 
displayed. 


Space Free 
The free memory on the hard disk is listed. 


Delete 
Click Delete to delete the selected projects. 


Expand 

Click Expand if you want to expand the size of a project in the database. Oracle will add 
another segment to its internal storage. When you click Expand the following dialog will be 
displayed: 


Expand Project Ea 


Project Name: pumpstat 


Database 


Additive Space 
Components: Sizes (MB): Resources: Free (MB): 
\\aitl 392.advabld1 53 


STB 0 


OK | Cancel | Help | 


Figure 3-37. Expand Project Dialog 


If you click OK then in the example of Figure 3-37 a new segment of 5 MBytes will be added 
for the CAEE database and nothing for the STB database. If you want to use other sizes for the 
added segments, select the database and click Edit or double-click the line. In the Edit dialog 
you can specify the actual size of the segment that shall be added. 


When the dialog pops up, Additive Sizes are set to 0 MBytes. Zero means that no additive 
segment will be added to the project’s database. 


Register 

If you have started your project with only some of the Builders installed and want to add other 
Builders later on, then the system must be informed about these new Builders. Select the project 
concerned and click Register if you have new Builders installed to integrate them into the 
project environment. Then the following dialog is displayed: 


3BSE 013 932R201 


Structure Builder User’s Guide 
Section 3.6.2 Project Menu 


Register Aspect Systems Ee 


Project Name: pumpstat 


~ Database 
Edit... | 
s° Space 


Components: Sizes (MB): Resources: Free (MB): 
\Naitl 392\advabld1 53 


Cancel | Help | 


Figure 3-38. Register Aspect System Dialog 


If the CAEE database was not used up to now and a new builder was installed which will use 
this database, then the project of this database will be created with the shown size. You can 
modify this value when you click Edit or double-click the line. 


Back-up 
Click Back-up if you want to back-up all data of the selected projects. Then the following 
dialog will be displayed: 


Edit Time Eg 
Date: 8/244EEE = 


Time; }10:49:23AM 


Cancel | 


Figure 3-39. Edit Time Dialog 


Enter a new date and time if you want to back-up the selected projects at a special time and click 
OK. When the entered time is reached the back-up will be started and the data will be copied to 
the Eobackup folder below Advabld1. 


Restore 

You can restore a project that was previously backed-up. To visualize the projects that can be 
restored, click the Backed-up button in the Projects area of the Project Administration dialog 
(see Figure 3-32). 


Select the project you want to restore and click Restore. Then the following dialog is displayed: 
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Restore Project Ea 


Backed-up Project Name: pumpstat 


Restore Project Name: 


Database 
it... 
_Edit.. | Space 
Components: Sizes (MB): Resources: Free (MB): 
\\aitl 392\.advabld1 
File System 
Space 
Resources: Free (MB): 


\wgitl 392\advabld1 


Cancel | Help | 


Figure 3-40. Restore Project Dialog 


Dialog Controls 


Restore Project Name 
The default name is the name of the backed-up project. You can overwrite this name. 


Database 
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Sizes 
The displayed sizes will be used for creation of the project’s segments in the database. 
Click Edit or double-click the line if you want to specify other sizes. 


The default size of a certain database reflects the used space of the project concerned 
before it was backed-up. If you modify this size it must be equal or greater than the shown 
size. 


Components 
The project’s databases are listed with their used size. 


Resources 
Under Resources the share name of the directory where the project data are stored is 
displayed. 


Space Free 
The free space on the hard disk is listed. 
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File System 


Resources 
Under Resources the share name of the directory where the project data are stored is 
displayed. 


Space Free 
The free space on the hard disk is listed. 


Space 
Space of Projects Ed 
Select Projects: Database Space Allocation [KBytes] 
Component: Free: Used: Total: 
CAEE 


we | 


Figure 3-41. Hard Disk Space Used by Projects 


Click Space to get a listing of the space consumed by all projects of a certain database. Select 
the database from the Select Component field. The listing includes information about the free, 
the used and the total reserved space in MBytes. 
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User to Project Assignments Area Controls 
Add 
Click the Add button to open the dialog shown in Figure 3-42. 


Assign User to Project Ea 


Projects: Access Rights 


@ Write 
™ Read 


Apply | Cancel | Help | 


Figure 3-42. Assign Users to Projects Dialog 


If you want to assign certain users to a certain project, select them in the Users or Projects 
column, specify the access right, and click OK or Apply. 


Delete 
Select the assignments in the User to Project Assignments list and click Delete. 
Change 


You can change the access right from read to write and vice versa. Select the assignments in the 
User to Project Assignments list you want to change and click Change. 


3.6.2.4 Upgrade 


Use the Project | Upgrade menu command to upgrade the Structure Builder specific project 
data from an older version of Structure Builder to the current one you are using. 


NOTE 


This command will upgrade the Structure Builder specific data only. See the 
documentation of other builders you are using within your projects for 
information about how to upgrade project data. 


NOTE 


Upgrade of project data is not necessary from Structure Builder version 3.1 to 
version 3.2 


When you select the Project | Upgrade menu command, the dialog shown in Figure 3-43 is 
displayed: 
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M Administrator Logon for Upgrade Ea 


Database: [ins-GIT1 392_e0 


~ Authentication Cancel | 


User: eostb 
Help | 
Password: I 


Figure 3-43. Upgrade Dialog 


Upgrading is meant as a task to be performed by the database administrator. You have to log in 
to the database as user eostb. This field is grayed, as there is only one user with this name 
possible. 


Type the database connect string and your administrator password into the corresponding fields 
and click OK. Then the following dialog is displayed: 


Upgrade Structure Builder Project Data Ea 


Structure Builder Versions ——. 


Upgrade from 


Available Projects: 


dob30r0 =3.1/0 


doelib3 3.0/0 
doenewl 3.0/0 
imex 3.1/0 
imex_lib 3.1/0 
indfest 3.1/0 
kesil5 3.0/0 
lib1 0r0 3.1/0 
librefdo = =3.1/0 
muronstat. 31/0 z| 


Figure 3-44. Projects Available for Upgrade 


The upgrade path is shown in the upper part of the dialog. In the example shown in Figure 3-44 
the offered upgrade works on project data created with Structure Builder of version 3.0/0, which 
will be upgraded to version 3.1/0. You can inspect the version of your Structure Builder with the 
Help | About Structure Builder menu command (see Section 3.6.6.5, About Structure 
Builder). 


In the lower part of the dialog the available projects and the corresponding Structure Builder 
version are displayed in a list box. You can select multiple projects in the list box. Projects that 
are already upgraded, cannot be selected. Click OK when you have selected the projects you 
want to upgrade. 
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3.6.2.5 Import 


Use the Project | Import menu command to import objects and object aspects. When you 
perform an import from files generated via the Project | Export command make sure to import 
the configuration data first. 


When you select the Project | Import menu command the following dialog is displayed: 


Import Data Eg 


Projects Mode 


Source: [tns:gitt 289_e0 | exp1 3:0 7] ™ Override piers | 
Target: [tns:git1 289_e0 | exp13:0 x] @ Keep 


- Source File{s}- 


Store to File | Load from File | Add... | Edit | Sort... | Remove 
Customer Data: Mapping: 
adyvantobjectsconfig.csy config.csv 
advantobjects.csv createeo.csv 
basic property.csv createeo.csv 
structureconfig.cs¥ config.csv 
structuredisplayconfig.csv config.csv 
structure.csv createeo.csv 


Delimiter 
© Tab © Semicolon Comma © Blank Other-| 


~ Error Lagging 


Log File: Browse... | Include 
__E__————— | lV Wamings 
Error Limit: fo 


Bad File(s): Enable Bad File Writing [~ 


Git | Cancel | Gorfigure | Help | 


Figure 3-45. Import Objects Dialog 


For more information about Import see Bulk Data Handling and Reuse Reference Manual. 


3.6.2.6 Export 
Use the Project | Export menu command to export object data and object aspect data: 


If any object in the active structure window is selected, then each selected object will be 
exported. If no object in the active structure window is selected, then all objects of the project 
will be exported. 


The following files generated by an export procedure are related to the Structure Builder: 


AdvantObjects.csv, BasicProperty.csv, Structure.csv. 
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Additionally you can also export the following object configuration data: 
° Object type definitions 

° Structure window definitions 

° Structure window display settings. 


These object configuration data are project specific. Other settings in the Structure Builder, for 
example in the aspect area are client specific and will not be exported. 


The following files will be generated for configuration data: 
AdvantObjectsConfig.csv, StructureConfig.csv, StructureDisplayConfig.csv. 


Data are exported in comma separated values format. Data stored in this format can easily be 
read by tools like Microsoft Excel as well as by the Project | Import menu command (see also 
Section 3.6.2.5, Import). 


When you select the Project | Export menu command the following dialog is displayed: 


Export Objects Eg 


Project 
tns:gitl289_ eo | exp1 3r0 = | 
~ Data Storage 


in Folder: Browse... | 
C:\work\export 


Note 


oe 


Range Naming for extracted objects — 
© All Objects use object names 
@ Selected Objects @ generate unique names 


IV Export includes Configuration Data 


Cancel | Help | 


Figure 3-46. Export Objects Dialog 


For more information about Export see Bulk Data Handling and Reuse Reference Manual. 
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3.6.2.7 Recent Project List 


3.6.2.8 Exit 


3.6.3 View Menu 


3.6.3.1 Toolbar 
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Under this menu item some of the projects you have previously opened, are listed. Click on one 
of the projects to open it again. In the login dialog, that will be displayed, you have to fill in 
your password, only. 


The string Recent Project List will only be shown the first time you open Structure Builder. 
Afterwards the string will be replaced by a project name. 


Use the Project | Exit menu command to exit Structure Builder. This command closes all your 
open projects implicitly. The log off process from the database will also be performed. 


Use the View | Toolbar menu command to display or hide the toolbar, which includes buttons 
for some of the most common menu commands in Structure Builder, such as Objects | New. A 
check mark appears next to the menu item when the toolbar is displayed. 


Toolbar 


The toolbar is displayed across the top of the application window, below the menu bar. You can 
pick it up with the mouse and drag it to any position on the screen you like. If you want to put it 
back to its original position, drag it just below the Structure Builder’s title window. Then it will 
snap into its home position. 


The toolbar provides quick mouse access to many menu commands used in Structure Builder. 


[¥es|ca) (-[=le |) (E] 


Figure 3-47. Toolbar 


Toolbar buttons exist for the following menu commands: 
* Object | New 

* Open | Objects 

* Edit | Cut 

* Edit | Copy 

* Edit | Paste 

* View | Compress 


* View | Compress Subtree 
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* View | Expand 

* — View | Expand Subtree 

* Window | Open Structure 
* Help | Contents 

* Help | On Context. 


Use the View | Status Bar menu command (always active) to display and hide the status bar, 
which describes the action to be executed by the selected menu item or depressed toolbar 
button, and keyboard latch state. A check mark appears next to the menu item when the status 
bar is displayed. 


The status bar is displayed at the bottom of the Structure Builder window 


Create, open or delete a structure window [3 (CAP [NUM |SCRL 4 


Figure 3-48. Status Bar 


In the leftmost area of the status bar help texts for menu items and toolbar buttons are displayed. 
If you decide after viewing the description of the toolbar button or menu command not to 
execute this command, then release the mouse button while the pointer is off the toolbar 
button’s or menu command’s area. 


In the right area of the status bar the number of objects selected in the active structure window 
and some keyboard settings are displayed. 
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3.6.4 Options Menu 


3.6.4.1 Project 


Use the Options | Project menu command to customize projects, structure, and display 
characteristics according to your personal wishes. Then the following dialog is displayed: 


Project(s} ; 
Connect String: Project Name: Add. | Edi. | Delete| 
~ 


exp12r0 
expl2rl 
exp12r3 


f.| 


Structure[s] : 
Name: Add... | Edit... | Delete| 
+ Mounting Location Structure Copy | 


++ Location Structure 


:= Function Structure Paste | 
== OCS-Structure 


Project Pool 
Display Item{s} ; 
Aspect Type: Attribute: Add... | Edit... | Delete | 
Basic Property 
Basic Property Name 
Basic Property Object Type 
Structure Abs.Ref.Des. 
Structure Prefix (Object) 


Heo | 


Figure 3-49. Set Options Dialog 


The Set Options dialog is split into three areas: 
° Project 

° Structure 

° Display Item. 


Your settings will be stored on your computer. That means that a person, working with the same 
projects on another computer, may use quite different settings. 


Project Area 


In the project list box all projects for which you have option handling defined are listed. As this 
information is stored on your client PC, it cannot be guaranteed, that this information is still 
valid. It may be that a certain project was deleted from another client PC. 


Select the project you want to refine the option handling for. 


To remove an entry from this list box, use the Delete button. 
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Project Area Controls 


Add 
Click Add if you want to add a project to option handling. Then the following dialog is 
displayed: 


Add Project Ea 


Apply | Cancel | Help | 


Figure 3-50. Options - Add Project Dialog 


The dialog lists the currently open projects, for which option handling is not yet activated. 
Edit 


Click Edit if you want to set certain project default settings used when Advant objects and 
aspect will be created. Then the following dialog is displayed: 


Set Project Options Ea 


Default Name Category: Customer ID bd | 
Background Color of Objects: ee v | 


Set to Defaults | Save as Defaults | 
Apply | Cancel | Help | 


Figure 3-51. Options - Set Project Options Dialog 


Dialog Controls 


Default Name Category 

Select the name category from the list box that shall automatically be inserted into the Basic 
Property aspect when an Advant object will be created. This category will also be displayed in 
the Advant object’s rectangle. 


Background Color of Objects 
Select a background color from the list box. 
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Delete 


Click Delete if you want to delete a project from the project list box. Deleting a project within 
the Options dialog does not mean, that the project will be deleted, but that it is no further 
available for setting of options. For projects not listed under Project, default values will be 
used. 


Save 


Click Save if you want to extract the selected project display set from the eostb.ini file to a 
separate file. 


Load 


Click Load if you want to add the additional project display sets to the existing eostb.ini file. 
Existing project display sets for structures will not be overwritten. To be sure to get all the saved 
display sets for the current project, first remove all the structure display sets. 


Structure Area 
In the Structure Area you can select a structure and define its appearance. 
Structure Area Controls 


Add 
Click Add to activate a structure for option handling. Then the following dialog is displayed: 


Add Structure Ea 


ture 
& Plant Documentation Structure 
+ Mounting Location Structure 
Library Structure 


Project Pool 
Apply | Cancel | Help | 


Figure 3-52. Options - Add Structure Dialog 


Select a structure from the list box. 
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Edit 


Click Edit to specify some display attributes of an Advant object. Then the following dialog is 
displayed: 


Set Structure Options Ea 


I Display Rectangles 


Building Rule for Absolute Reference Designations: 


Set to Defaults | Save as Defaults | 
Apply | Cancel | Help | 


Figure 3-53. Options - Set Structure Options Dialog 


Dialog Controls 


Display Rectangles 
Check the check box if you want the Advant objects displayed with a thin black outlining 
rectangle. 


Building Rule for Absolute Reference Designations 

Two types of reference designations can be distinguished: relative and absolute ones. A relative 
reference designation can be assigned to a certain Advant object. The absolute reference 
designation of an Advant object is built by concatenating the absolute reference designation of 
the parent object with the relative reference designation of the Advant object under 
consideration. The way the concatenation is performed, can be controlled by building rules. 
Separators may be inserted in between the designations for a better visualization. 


If for example an Advant object “Signal A” has a relative reference designation A2 and its 
parent object an absolute reference designation =A1, then the absolute reference designation of 
Signal A is =A1.A2, if a dot is used as separator. 


Each relative reference designation may have a prefix. The prefix specifies the type of the 
reference designation. In the absolute reference designation of the parent object in the above 
mentioned example, ’=’ is the prefix. The prefix may also be used as separator. Whether a 
separator is used or not and the type of separator is controlled via the building rules. 


Available building rules are: 


° None 
° Prefix 
° Dot 


° Prefix to Dot. 


The None rule has the following meaning: relative reference designations are concatenated to 
build the absolute reference designation without using a separator in between. But when the 
type of the reference designation changes, the prefix is used as separator. 


3-63 


Structure Builder User’s Guide 
Chapter 3, Configuration/Application Building 


If you select the Prefix rule, the prefix is used as separator between relative reference 


designations. When no prefix is defined for a certa 
will be inserted. 


If you select Dot rule, the dot is always used as se 


in relative reference designation, no separator 


parator between relative reference 


designations, except at positions, where the type of the designation changes. Here the prefix is 


used as separator. 


The Prefix to Dot rule has the following meaning 


: For relative reference designations with 


defined prefix, a dot will be shown instead of the prefix, unless the for cases, where the type 
changes. In this cases the prefix will be shown as usual. 


In Figure 3-54 an example is shown for the building rule Prefix. The absolute reference 
designations are shown on the object displays. The absolute reference designations are built by 
concatenating the relative reference designations using the prefix as separator. If you choose 
building rule Dot the prefix will only be displayed, when the type of the designation changes. 
The reference designation of CARDRIVE_Motorstarter would be like this: =P1.M1-Q1. 


P30] exp13r0 (otmayer): = Function Structure 


BEES 


Example Project EXP13R0 


Project | 


Ladle Tower 


Process Object | 


=P2=M1 CARDRIVE Drive System 


[ey <P2=M1 OT 


CARDR 


VE_Motorstarter 


Control Module 


CARDRIVE_MCC 


=P2=M1 


Binder 


CARDR 


=P2=M1 


VE_IO 


Binder 


(4) <P2=Mi-Mi CARDRIVE_Main_Drive Motor 
[9 =P2=M1=RUN_R CARDRIVE_RUN_R Signal 


=P2=M1=RUN_L CARDR 


VE_RUN_L 


Signal 


a =P2=M1=READY = CARDR 


VE_READY 


Signal 


[5p =P2=M1=FB_L CARDRIVE_FB_L Signal 
Ef =P2-MI=FB_R-CARDRIVE_FB_R Signal = 


Casting Machine 


Process Object | 


Torch Cutting Machine 


Process Object | 


Figure 3-54. Example of Reference Designation Display 


Delete 


Click Delete if you want to delete a structure from the list box. Deleting a structure within the 
Options dialog does not mean to delete a structure, but that it is no further available for option 


handling. 
Copy 


Click Copy to take the selected structure display set to a Structure Builder internal paste buffer. 


Paste 


Click Paste to read the Structure Builder internal paste buffer and to overwrite the selected 


structure display set with the paste buffer content. 
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Display Item Area 


In the Display Item area you can specify which attributes of aspect types will be displayed and 
how they will look like. Further on you can select a font. 


Display Item Area Controls 


Add 
Click Add if you want to a certain attribute of an aspect type to the option handling. Then the 
following dialog is displayed: 


Add Display Item Ea 


Aspect Type: Structure 


Attribute: JabsRetDe 
Apply | Cancel | Help | 


Figure 3-55. Options - Add Display Items Dialog 


Select an aspect type and the corresponding attribute from the list boxes. This attribute will be 
added to the display of an Advant object. 


Edit 
Click Edit to determine the area that will be used for the display of an attribute. Then the 
following dialog is displayed: 


Distance from top Set Display Item Options Ea 


Distance from left side of the 
Advant object’s rectangle 


Length of the area used 


to display the attribute 
Font... | 


Set to Defaults | Save as Defaults | 
Apply | Cancel | Help | 


Figure 3-56. Options - Set Display Item Options Dialog 
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Other Dialog Controls 


Auto 
Structure Builder will determine the optimum height of the area. But you can use your own 
values instead. 


Font 
Click Font to open a standard font selection dialog box. 


Delete 
Click Delete to delete a display item from the list box. Deleting a display item means, that it is 
no further available for option handling. 
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3.6.5 Window Menu 


3.6.5.1 Structure 


Use the Window | Structure menu command to open one or several structure windows, to add 
a new structure or to delete an existing one. Then the following dialog is displayed: 


Open Structure[s) Ed 
Project: pumpstat ’ 
Structure: Add... Delete | 


& Plant 

+ Mounting Location Structure 
++ Location Structure 

= Function Structure 


== OCS-Structure 
Library Structure 
Project Pool 


Figure 3-57. Open Structure Dialog 


To open one or several structure windows, select the corresponding project at first and then the 
structures to be opened and click Open. 


Shortcut 
Toolbar button: [=] 


Dialog Controls 


Project 
Displays the currently opened projects. You can select one out of the list. 


Add 

You can add a new structure to the selected project. When you click Add the Add Project 
Structure dialog will be displayed (see Figure 3-58). To this new structure you can copy 
Advant objects later on. 


Delete 

You can select several structures from the structure list and delete them. Structures must be 
empty before you can delete them. Use the Remove from Structure menu command to make a 
structure empty (see Section 3.7.1.4, Remove From Structure). 


Structure 


Lists all available structures of the selected projects. You can select several structures. Click 
OK to open the structure windows. 


3BSE 013 932R201 3-67 


Structure Builder User’s Guide 
Chapter 3, Configuration/Application Building 


3.6.6 Help Menu 


3.6.6.1 Contents 


3.6.6.2 On Context 


Additional Dialogs 
Add Project Structure dialog 


Add Project Structure Eg 
Structure Name: se 
ea 


Figure 3-58. Add Project Structure Dialog 


You can type in the name of a new structure you want to create. If you want to insert a 
name similar to one you have already used before, you can select the previous name from 
the list box and modify this name afterwards. 


Use the Help | Contents menu command (always active) to display the opening screen of help. 
From the opening screen, you can jump to step-by-step instructions for using Structure Builder 
and various types of reference information. 


Once you open help, you can click the Contents button whenever you want to return to the 
opening screen. 


Shortcut 


Toolbar button: 


Use the Help | On Context menu command (always active) to obtain help on some portion of 
Structure Builder. When you choose the toolbar’s Context Help button, the mouse pointer will 
change to an arrow and question mark. Then click somewhere in the Structure Builder window, 
such as another toolbar button. The help topic will be shown for the item you clicked. 


Shortcuts 
Toolbar button: h? 
Keys: Shift+F1 


3.6.6.3 How to Use Help 
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Use the Help | How to Use Help menu command for instructions about using help. 
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3.6.6.4 Release Notes 


Use the Help | Release Notes menu command to open the release notes of the current version of 
Structure Builder. 


3.6.6.5 About Structure Builder 


Use the Help | About Structure Builder menu command to display the copyright notice and 
version number of your copy of Structure Builder. 


3.7 Configuration/Application Building Menus; Object Context 
3.7.1 Object Menu 


3.7.1.1 New 


Use the Object | New menu command to create a new Advant object. Then the following dialog 
is displayed: 


New Object(s) x] 
Name Category: [Customer ID 7] 
Name: 

Type: [2 Wdg Trafo x] Customize... | 


- Pasition > - Object Relative Reference Designation 
@ &sChild{ren) 
C Above - Same Level Prefix: Reference Designation: Control: 


™ Below - Same Level | 


Create fi Object(s) 


Apply | Cancel | Help | 


Figure 3-59. New Object Dialog 


To create a new Advant object select a category from the list box, type in a name for the new 
object and select the Advant object type from the list box. With the radio buttons you can 
specify where in the structure hierarchy — relatively to the selected parent object — the new 
element shall be inserted. 


Shortcut 
Toolbar button: La] 


3BSE 013 932R201 3-69 


Structure Builder User’s Guide 
Chapter 3, Configuration/Application Building 


3-70 


Dialog Controls 


Name Category 

Select a name category from the category list box. An aspect type may have several categories 
as subtypes. The name of the Advant object will be stored in a basic property aspect of the 
selected category. Several categories are supplied by Structure Builder: 


° Customer ID 

° Document ID 

° Function ID 

° Instance ID 

° Instrumentation ID 
° Location ID 

° Mechanical ID 

° Process ID 

° Product ID 


° Reference ID. 


Name 
Enter a valid name for the Advant object you want to create. 


Type 
Select a type for the Advant object. Several types are supplied by Structure Builder. 


Customize Object Types 
See Section 3.7.5.1, Customize Object Types. 


Position 


As Child(ren) 
Select As Child(ren) when you want to insert the new Advant object as child relatively to the 
selected Advant object. 


Above - Same Level 
Select as Above - Same Level when you want to insert the new Advant object as sibling above 
the selected Advant object. 


Below - Same Level 
Select as Below - Same Level when you want to insert the new Advant object as sibling below 
the selected Advant object. 


Object Relative Reference Designation 


You can specify — just when you create the Advant object — the relative reference designation 
the object will obtain in the active structure. As relative designations will be concatenated to 
absolute ones, this may not be very useful, when the active window is a pool window, because 
of the missing hierarchy of Advant objects within the pool. For more information about relative 
reference designations see Section 3.5.9.10, Inserting Reference Designations, Figure 3-86, and 
Appendix B, Glossary of Terms, page B-5. 
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Create Objects 

If you want to create more than one Advant object of the specified type, enter the number of 
objects. This may be meaningful if you want to create a lot of Advant objects that differ only 
slightly. After creation you may modify individual Advant objects. 


If digits are at the end of the name, these numerals will be incremented for each of the objects 
created within a series. If you want to create three objects Motor1, you will get Motor1, Motor 
2, and Motor3. The same works for Motor001. 


Blanks at the beginning or at the end of the object name will be removed. 


Naming Conventions 


From Structure Builder’s point of view you are free to insert any 8-bit national character. But 
some other Builders use the text for special purposes. 


If you are going to use Function Chart Builder or On-line Builder, you should be aware of the 
following restrictions: 


The Name attribute of an object’s Basic Property aspect (category Customer ID) has to follow 
° The DB name syntax if the object covers 


— DBElement aspects, and/or 


— Circuits aspects only instantiating DB type circuits. 
° The PC name syntax if the object covers only 
Circuit aspects only instantiating PC type circuits. 


° The common subset of PC and DB name syntax if the object covers only 
— Circuit aspects instantiating both, DB and PC type circuits, or 


— DBElement aspects together with at least one Circuit aspect instantiating a PC type 
circuit. 


The Description attribute of a DBElement aspect has to follow the DB name syntax. 
The Description attribute of a Circuit aspect has to follow 

° The DB name syntax, if the circuit only instantiates DB type circuits, 

° The PC name syntax, if the circuit only instantiates PC type circuits, 


° The common subset of DB and PC name syntax, if the circuit instantiates both, DB and PC 
type circuits. 


Syntax Rules for DB Element Names 

Rules: 

° Names must not consist only of numerals, or periods, or numerals and periods (dots). 
° Names must not start or end with a hyphen. 


° Names must not be equal to an item designation, for example AI1.1, unless it is its own 
item designation. 


° Substrings of names must not equal “.Bn’, “.In’”, “.[Ln’”, “.Rn’, where n is a number, 
except for names of DAT elements. 
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Table 3-5. Allowed Characters - DB Element Names 


Name of Character 


Printed Character 


Remark 


Double opening quote 


Hash mark # 

Dollar $ 

Ampersand & 

Asterisk * 

Plus sign + 

Hyphen - Do not use as first or last 
character of a name 

Dot Do not combine only numerals 
and dots 

Zero ... Nine 0...9 Do not combine only numerals 
and dots 

Question mark ? 

At sign @ 

A...Z AZ 

Left square bracket [ USA) 

Back slash \ USA") 

Right square bracket ] USA") 

Caret ‘ 

Underscore _ 

a...Z a...Z 

Left brace { USA”) 

Vertical bar | USA") 

Right brace } USA”) 

Tilde ~ USA, SWE) 

Adieresis A GER, SWE") 

Odieresis fe) GER, SWE") 

Udieresis U GER, SWE!) 
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Table 3-5. Allowed Characters - DB Element Names (Continued) 


Name of Character Printed Character Remark 
Aring A SWE") 
adieresis a GER, SWE") 
odieresis 6 GER, SWE") 
udieresis a GER, SWE") 
aring a SWE") 
germandbls B GER") 


(1) allowed only, if the specified character set is selected for the project in the Application Builder 
(USA=US english, GER=german or SWE=swedish). 

Syntax Rules for PC Element Names 

Rules: 

° Names must not start with a digit or an underscore. 


° Names must not be equal to a PC program item designation, for example PC2. 


Table 3-6. Allowed Characters - PC Element Names 


Name of Character Printed Character Remark 


Space 


Exclamation mark | 


Double opening quote 


Hash mark # 
Dollar $ 
& 


Ampersand 


Single opening quote 


Opening parenthesis ( 
Closing parenthesis ) 
Asterisk . 
Plus sign + 
Comma ; 
Hyphen - 
Dot 
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Table 3-6. Allowed Characters - PC Element Names (Continued) 


Name of Character Printed Character Remark 

Slash / 

Zero ... Nine 0...9 Must not be used as first 
character 

Colon 

Semicolon ‘ 

Equal sign = 

Question mark ? 

At sign @ 

A...Z A...Z 

Left square bracket [ USA") 

Back slash \ USA") 

Right square bracket ] USA") 

Underscore 2 Must not be used as first 
character 

a...Z a...Z 

Left brace { USA”) 

Vertical bar | USA) 

Right brace } USA") 

Tilde ~ USA, SWE") 

Adieresis A GER, SWE") 

Odieresis fe) GER, SWE") 

Udieresis U GER, SWE") 

Aring A SWE") 

adieresis a GER, SWE") 

odieresis 6 GER, SWE") 

udieresis u GER, SWE") 

aring a SWE") 

germandbls B GER") 


(1) 
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allowed only, if the specified character set is selected for the project in the Application Builder 
(USA=US english, GER=german or SWE=swedish). 
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Use the Object | Open menu command to open an existing Advant object. Then the Object 
Window is displayed: 


exp13r0 (otmayer): Node_1 ile Es 


Aspects 


Follow Object Selection New.. | Delete | 
Description: Category [or Type}: ad 


Customer ID 


‘Control Functions Node Control Software 


DBSection DBSection 

Electrical Structure Data El. Structure 

Structure == OCS-Structure 

Structure Project Pool 
Views 


Communication Configuration Open | 
Help ; 
Node Function Chart Help | 


Online 
Source Tevt nd Close 


Figure 3-60. Object Window 


The object window may stay open on your display while you perform other activities within 
Structure Builder. If you check the Follow Object Selection field the window’s content will be 
updated when you select for example another Advant object in a structure window. 


The object window is split into two major areas, the aspects and the views area. 


In the Aspects area you can select an aspect in the list box and inspect or modify its settings. 
Further on you can add a new aspect or delete an existing one to the selected Advant object. 


In the list box of the Views area the views of the selected aspect, belonging to the Open 
command, are listed. You can select a view and open it. If the selected aspect does not belong to 
Structure Builder, the corresponding builder will be started. 


Shortcut 


Toolbar button: 


Dialog Controls 


Follow Object Selection 
Check this check box if you want that the content of the object window is updated while you 
select other Advant objects in a structure window. 


New 
If you want to add another aspect to the selected Advant object, click the New button. Then a 
corresponding dialog will be displayed (see Figure 3-61). 
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Edit 

When you click the Edit button the so-called Edit Aspect Registry dialog will be displayed. 
With this dialog you can inspect or modify registered data of the selected aspect (see 

Figure 3-62). 


Delete 

Click the Delete button to delete the aspect that is currently selected in the aspect list box. You 
can select one aspect at a time. You cannot delete a pool structure aspect or a project global data 
aspect from the Object Window. 


More 

If you click the More button a new window — the Command Window — pops up which list one 
or several commands that can be executed. At least the Open command is available. The 
number of commands depends on the selected aspect type. The available aspect types depend on 
the Builders installed. 


If you select for example a basic property aspect, the Command Window shows the Open 
command. If you click Open then the Set Attributes of Basic Property Aspect window is 
displayed (see Figure 3-84). 

If you select a structure aspect then the Command Window shows the Open and the Structure 


command. If you click Structure the corresponding structure window will be displayed. 


Aspect List Box 

The aspect list box consists of two columns, Description and one with adjustable title. In the 
example in Figure 3-60 the second column is set to Category (or Type). You can select between 
several types. 


Views 
In the Views list box the available views of the Open command of the selected aspect are listed. 
You can select one and open that view by clicking Open. 


Additional Dialogs 
* New Aspect dialog 


New Aspect Eg 


Aspect Type: 
® ; 


OK 


DBElement | 
DBSection paca 
Node Control Software | 


Project Global Data 
Project OCS Defaults 


Help 


Aspect Description: 


[Basic Property 


Figure 3-61. New Aspect Dialog 
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Use the New Aspects dialog to add an aspect to the selected Advant object. All aspect 
types of the installed Builders will be displayed. Select an aspect type and enter an aspect 
description and click OK. 


¢ Edit Aspect Registry dialog 


Edit Aspect Registry Ea 


- Basics 


aa 

Description: [al Signal L «| 
Cancel 

Type: Structure _ Cancel _| 


Owner: Structure Builder __ tel | 
Status: Draft x 


Aspect Relative Reference Designation: 


Prefix: Reference Designation: | 


SS 


; Dates and Users 
Created on: 20.10.97 15:04:36 by: = Start Up 


Modified on: by: 


Figure 3-62. Edit Aspect Registry Dialog 


The Edit Aspect Registry dialog displays basic settings of the selected aspect. Further on 
you can change the description, status, prefix, and the relative reference designation of the 
aspect. 


3.7.1.3 Rename 


Use the Object | Rename menu command to rename an existing Advant object. Then the 
following is displayed: 


Select Name Category: [CustomerID ti (tsti‘:™SOSOSC;CSY 
New Name: Jas is 
Substitute Characters): i2a-0ttti(‘i‘Sésd” with: iis 


New Type: REE Board + 


Apply | Cancel | Help | 


Figure 3-63. Rename Objects Dialog 
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With the Rename Objects dialog you can rename one or several existing objects. As an Advant 
object may have several names, you should at first select the category, for which you plan to 
change the name. You have the alternative to specify the new name directly or to substitute parts 
of the name by a given string. Further on you may change the type of the Advant objects. 


When you have several Advant objects selected which do not belong to one type and you insert 
a new name, then the type is set to As Is, which means, that the individual types will not be 
replaced during the rename operation. But you can supersede the original types by specifying a 
new one common for all selected Advant objects. 


In the example shown in Figure 3-63 no new name is specified. Instead the string “21” will be 
replaced by “1” in the names of all selected objects. Furthermore, the object type will be set to 
Board. 


Dialog Controls 


Select Name Category 
Select the category of the Advant object you want to modify. 


New Name 
Enter the new name of the Advant object. If you have selected more than one Advant object, all 
objects will get the same name. 


Substitute Character(s) 

Enter the part of the Advant object’s name that shall be replaced. 

with 

Enter a string with which the part, that was specified under Substitute, shall be replaced. 


New Type 
Select a new type for the selected Advant object from the list. 


3.7.1.4 Remove From Structure 


3.7.1.5 Delete 


3.7.1.6 Save As 
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Use the Object | Remove from Structure menu command if you want to remove an Advant 
object from a structure. This command will not delete the Advant object, because it may also be 
placed in another structure. At least it is part of the pool. Further on this command will work 
only, if the object has no children in the selected structure. 


The Remove from Structure menu command is not available for selected windows. 


Use the Object | Delete menu command to delete the selected Advant object(s) together with all 
children. 


With the Object | Save As menu command you can store names of Advant objects of the 
selected project in text format. Currently, the names of Advant objects of type Signal are stored 
in a text file. The names belong to the name category Customer ID. The stored text file is meant 
to be used by the Display Builder as signal list. 
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3.7.1.7 Exit 


3.7.2 Edit Menu 


3.7.2.1 Cut 
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The default directory for the file is the project directory 
(\\<servername>\AdvaBld1\data\<project name>, where AdvaBld1 is a share name). 


If you currently have more than one project open, select a structure or pool window of the 
project, for which you want to create the signal list and issue the Save As command afterwards: 


Save List of Objects 


Save in: J exp1310 | 


File name: [Signals.ot 
Save as type: [DvB Signal List (OT) 7] Cancel | 


Figure 3-64. Save List of Objects Dialog 


Example of a Signal List: 
AI Signal 11 
AI Signal 12 
AI Signal 13 
AI Signal 14 
AI Signal 15 
AI Signal 16 
AI Signal 17 
AI Signal 45 


Use the Object | Exit menu command to exit Structure Builder. This will close all open 
projects. 


Use the Edit | Cut menu command if you want to delete the current selection - for example 
some Advant objects - in one structure window and to insert this into another structure. Cut is 
not possible between different projects. When you use the Cut command, the selection will be 
copied to the clipboard. The selection will be surrounded by a broken line. It will be visible until 
the Paste command is executed. 
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3.7.2.2 Copy 


3.7.2.3 Paste 


Shortcut 


Toolbar button: 


Key command: Ctrl+x 


Use the Edit | Copy menu command if you want to copy the current selection to the clipboard. 
You can insert the contents of the clip board into another structure of the same or another 
project using the Edit | Paste menu command. 


Shortcut 
Toolbar button: 


Key command: Ctrl+c 


Use the Edit | Paste menu command if you want to insert the content of the clipboard into the 
currently active structure. If the contents of the clip board was filled using the Edit | Cut 
command, the Paste command will result in a move of the selected object(s). If Edit | Copy was 
used, the Paste command results in an new object. 


The objects will always be inserted as children of the selected object in the destination structure. 


Paste is not possible into an empty structure. If you want to place an existing Advant object into 
an empty structure, you can drag it into the structure window. Alternatively, you can create a 
new object. 


Shortcut 
Toolbar button: 


Key command: Ctrl+v 


3.7.2.4 Paste Without Subtree 


3.7.2.5 Paste Special 
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If you only want to copy selected objects without their subtrees, you can issue the Paste 
Without Subtree menu command. 


When you have copied the selected Advant objects with the Edit | Copy menu command to the 
clip board, use the Edit | Paste Without Subtree menu command to copy the selected objects 
only. This situation is illustrated with Figure 3-18. 


Use the Edit | Paste Special menu command if you want to specify the insertion of the Advant 
objects into the destination structure in a more detailed manner. Then the following dialog is 
displayed: 
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Paste Special Ea 


Action — —— _+-Relative Position aaa 
OK 

™ Place @ &s Child{ren) 

@ Copy C Above - On Same Level _Cancel_| 
7 With Subtiee ™ Below - On Same Level Help | 

~ Include/Exclude 
Copy Aspects of Type: Don't Copy Aspects of Type: 
Project Global Data 

Circuit 

DBElement 

DBSection 


Node Control Software 
Project OCS Defaults 
Type Circuit 


cs ea 


Figure 3-65. Paste Special Dialog 


You can specify that the Advant object shall be placed or copied into the destination structure. 
Between different projects, Copy is possible, only. Further on you can specify where the 
Advant object shall be inserted relative to the selected destination object. It is also possible to 
exclude aspects of certain aspect types from the Paste operation. 


The Don’t Copy Aspects of Type list box lists besides the aspect types you have excluded from 
being pasted, aspect types that cannot be copied like structure aspects and those aspect types 
that are part of the source project, but not registered in the destination project. 


Dialog Controls 


Action 
You can select either Place or Copy. Place is possible within one project, only. Furthermore, 
you can specify whether the action shall be performed with or without subtrees. 


Relative Position 
Select the position where the object shall be inserted relative to the selected destination object. 
Possible values are: As Child(ren), Above - On Same Level, Below - On Same Level. 


Include/Exclude 

Move aspect types you do not want to be included in the paste operation, to the right box. These 
commands are only available when Action is set to Copy. You can initiate the movement by 
selecting an aspect type in the left list box and clicking the following button: 
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3.7.2.6 Select All 


3.7.2.7 Copy Bitmap 


3.7.3 View Menu 


3.7.3.1 Expand 
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Deselected aspect types can be moved to the left side by clicking the following button: 


Alternatively, you can move an aspect type by double-clicking it. 


Use the Edit | Select All menu command if you want to select all Advant objects of the 
currently active structure window. 


Use the Edit | Copy Bitmap menu command to copy the contents of the whole or of parts of the 
active structure window to the clipboard. The structure will be stored as bitmap in WMF format. 
If you insert the bitmap with Edit | Paste menu command for example in Microsoft Word 97, 
you can still edit the text part of the bitmap. 


What will be copied to the clipboard, depends on your selection within the structure window. 
First of all the wysiwyg principle is followed: collapsed structures will be copied as collapsed 
structures to the clipboard. 


If no Advant object is selected, the whole structure — independent on the vertical size of the 
structure window — is copied. The same applies, if all objects are selected. 


If one Advant object is selected, this object together with its expanded children objects is 
copied. The same applies for a range of objects. If you have performed a disjoined selection, the 
whole range from the upper to the lower object will be copied to the clipboard. An example of a 
disjoint selection is shown in Figure 3-22. 


Use the View | Expand menu command if you want expand the subtree of an selected Advant 
object. If a compressed structure is located below an Advant object, the object is marked with a 
*+’ sign at the left side of the object (see Figure 3-66). The Expand command expands the next 
lower level of the subtree (see Figure 3-67). Additional subtrees on lower level will be displayed 
in compressed form. 


Shortcut 


Toolbar button: 
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G2 exp1310 (otmayer): == OCS-Structure 


ena Example Project EXP13R0 Project 


gee) ==N1 Network 1 


fly ==N2 Network 2 


fly ==N3 Network 3 


Figure 3-66. Compressed Subtree 


i€@ exp1 310 (otmayer): == OCS-Structure 


a i p Example Project EXP13R0 Project 


Network 1 


Node_1 


Node 


Node_2 


Node 


Node_3 


Node 


Node_4 


Node 


Node_5 


Node 


Network 2 


Net 


Figure 3-67. Partly Expanded Subtree 


3.7.3.2 Expand Subtree 


Use the View | Expand Subtree menu command if you want to expand a subtree with all lower 


level subtrees (see Figure 3-68). 


Shortcut 


Toolbar button: 


ica exp13r0 (otmayer): == OCS-S 


tructure 


Example Project EXP13R0 Project 


Bay ==N1 Network 1 


Ee) ==C1 Node_1 


Node 


GEE ==DI100__ DSDI_1104 


Board 


DSDI_110-D1.1 


Channel 


S) (ad ==] 
iad 


ALARM_1 


Signal 


fp ==2 


DSDI_110-D1.2 


Channel 


fp ==3 


DSDI_110-D1.3 


Channel 


ofp ==4 


Fa PI Proscure Lous Sinnal 


DSDI_110-DI.4 


Channel 


Figure 3-68. Completely Expanded Subtree 
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3.7.3.3 Compress Subtree 


Use the View | Compress Subtree menu command if you want visualize an expanded subtree 
in compressed form. All subtrees located below the selected Advant object will be displayed in 
compressed form. 


Shortcut 


Toolbar button: [=] 


3.7.3.4 Compress All 


Use the View | Compress All menu command if you want to visualize the whole structure in 
compressed form (see Figure 3-69). 


Shortcut 


Toolbar button: 


ica exp1310 (otmayer): == OCS-Structure 
Example Project EXP13R0 Project 


Figure 3-69. Compressed Structure 


3.7.3.5 Filter Objects 


Use the View | Filter Objects menu command to select certain Advant objects according to 
criteria specified in a filter. Then the following dialog is displayed: 
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Filter Objects Ea 


Project: Pumpstat x 
Edit Filter... | Select Filter... | 


Get all objects of type <Type> positioned in structure <Structure>. 


Selected Filter: 


~ Parameters 
Type [s ignal 
Structure [== OCS-Structure 


Cancel | Help | 


Figure 3-70. Filter Objects Dialog 


The result of the filter operation is displayed in a Selected Pool window. In contrast to structure 
windows a pool window does not show any structure information. 


Dialog Controls 


Project 
Select a project out of the list. The list includes all currently open projects. 


Use SQL Statement in File 

This control shows the currently selected file, in which the filter function is coded. It holds the 
SQL statements that perform the filter function. Structure Builder is coming along with some 
ready-to-use filters. 


You can overwrite this field with the path and file name of another filter file. 


Browse 

Use the Browse button if you want to select another filter. 

Edit 

Use the Edit button if you want to modify the filter. When you press the Edit button the 
selected file will be opened by the Notepad editor. 
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Description 


The filter function is shortly described. Parameters that you can specify are surrounded by angle 


brackets 


Parameters 


With Parameters you can adapt the selected filter to your special needs. In the example in 
Figure 3-70 the object type of the Advant objects is restricted to Signal. You can use the 
labelled edit fields to specify values for the parameters. 


The View | Filter Objects menu command is available only, if at least one structure window is 


open. 


3.7.3.6 Filter Aspects 


Use the View | Filter Aspects menu command if you want to specify filter conditions for the 
aspect area of the currently active structure window. Then the following dialog is displayed: 


Filter Aspects Ea 


Aspect Types: 


v 


4 


Vv 


LA) IK 


iv 
[JEl Layout Diagram 


Circuit 
DBElement 
|DBSection 
Document 
El. Cable 
EL. Circuit Diagram 

El. Connection Diagram 
JEl. Device 

El. Function 


IEI. Report Cancel 
al 
JEL. Terminal Bar 


JEL Overview Diagram 


El. Structure 


Figure 3-71. Filter Aspect Types Dialog 


The Aspect Types list box lists the available aspect types. Only checked aspect types will pass 
the filter and will be listed in the aspect area of the structure window. With Options you can 
adjust the filter to your special needs. 


All aspect types are checked in as default and will be shown in the aspect area of the Structure 
Builder. You can change this default configuration by the View | Filter Aspects... dialog and 
you can save it by executing the command Format | Save As Default. 


For each structure you can specify an own aspect filter. The filter is active until you deactivate 
it. To deactivate the filter, check all check boxes in the View | Filter Aspects dialog and select 
Options off in the Options dialog. 


The filter has an influence on the aspects listed in the aspect area only, not on the Object 


Window. 
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Dialog Controls 


Aspect Types 

The Aspect Types list box list all aspect types available in the project. To the left of the name is 
a check box. If the box is checked the aspect type will be shown in the aspect area of the 
structure window. You can toggle the check mark by clicking into the box. Alternatively you 
can select an aspect type and click Hide or Show to deselect or select an aspect type for the 
filter. 


Hide 
Select an aspect type and click Hide to deselect that aspect type. 


Show 
Select an aspect type and click Show to select that aspect type. 


Options 
With Options you can specify the filter criteria more detailed. When you click the Options 
button, another dialog will be displayed. 


Additional Dialogs 
Options dialog 


Filter Aspects - Set Options ES 


™ Options off 


— icy : * 

Filter By Value: 

r = Apply 

[Modified By 7] [= ha | Jotmayer 7] __Aeely _| 
Cancel | 

Then By Value: 

[Rel Ref Des. (Aspe: x] |= a fur 7] Help | 

Then By Value: 


[Status 7] iE x] [Dratt 7] 


[ Case Sensitive 


Figure 3-72. Filter Aspects - Set Options Dialog 


In the Filter Aspects - Set Options dialog you can specify up to three criteria that must be 
fulfilled for an aspect to be listed in the aspect area of the structure window. You can 
disable the specified options with the radio buttons Options off and Options on. 


The dialog consist of three columns: Attribute (Filtered By), operator, and Value. If you 
want to specify a criterion for the filter, proceed as follows: 


a. Select from the Attribute list box an attribute of the aspect you want to specify for 
the filter. 


b. Select from the second list box an operator 
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| | ~——s Object = Modified By [Rel.Ref.Des. (Aspect)) Created By 


c. Enter a value in the Value field. 


Available attributes are: 


— Description 
— Type 

— Created 

— Created By 
— Modified 

- Modified By 


- Status 


— Prefix (Aspect) 
— Rel. Ref. Des. (Aspect). 


The filter will execute row by row. If no value is given for a certain row, the filter ignores 
this row and the following ones. 


The operation of the filter is explained with the following example: 


Figure 3-73 shows the aspect area of a certain structure without an active filter. In 
Figure 3-74 you see the same aspect area after executing the filter as shown in Figure 3-72. 


Created 


Modified Type Description 


1 [CARORIVE|O_| 


CARDRIVE_|O. otmayer 
| 3 |CARDRIVEIO —atrmayer 


| 4 (CARDRIVE_[O 


| 5 |CARDRIVEIO —atmayer 
| 6 _CARDRIVE_[O otmayer 
| 7 |CARDRIVE_O otmayer 


otmayer 
otmayer 
otmayer 
otmayer 
otmayer 
otmayer 
otmayer 


619/98 13:36 
619/98 13:36 
6419/98 13:36 
619/98 13:36 
6419/98 13:36 
649/98 13:36 
6/23/98 15:12 


Basic Property Basic Property 
6/30/99 10:24 Draft El. Circuit Diagram = Circuit Diagram Output 
6/30/99 10:24 Draft El. Circuit Diagram Circuit Diagram Input 

El. Structure Electrical Structure Data 
8/2699 17:30 Draft Structure = Function Structure 
6/26/99 17:30 Draft Structure Project Pool 
8/26/99 17:29 Draft Structure + Mounting Location Structure 


= 
4 rf AspectArea / Natt | 


|__| ___ Object 


Figure 3-73. Filter Example: Unfiltered Aspect Area 


Modified By Rel.Ref.Des. (Aspect), Created By Modified Description 
CARDRIVE_lO otmayer 1 otmayer 619/98 13:36 6/30/99 10:24 Dratt El. Circuit Diagram = Circuit Diagram Output | 
sl 
rf AspectArea f Nall E 
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Figure 3-74. Filter Example: Filtered Aspect Area 
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3.7.3.8 Find Object 
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Use the View | Sort Aspects menu command if you want to specify the sort order of selected 
rows in the aspect area of a structure window. Then the following dialog is displayed: 


Sort Aspects Ea 


Sort By 
~ OK 
Modified ~] © Ascending | 
™ Descending } Apply | 


—Then By Cancel 


[Created By 7] c Ascending Help 


i 


Then By 


= @ Ascending 


™ Descending 


Figure 3-75. Sort Aspects Dialog 


The sorting order can be defined by three parameters. The topmost parameter specifies the 
primary rule, the following two the consecutive sorting order. For each row you can select the 
parameter from a list box. 


For each parameter you can specify, whether sorting shall be performed ascending or 
descending. In the example of Figure 3-75 the list will be sorted at first in ascending order for 
the Modified attribute and then in descending order for the Created By attribute. The third 
parameter is not specified. 


With the View | Find Object menu command you can search for a certain Advant object. Select 
the Project and the Name Category from the list boxes, enter the Name of the Advant object, 
you want to search for, and select the Structure Name, in which the search shall be carried out. 


If the Advant object was found, it is selected in the corresponding structure window, otherwise a 
message will be displayed. 


If you want to search for an Advant object rather in the whole project than in a certain structure, 
then select Project Pool in the Structure Name list box. 


The View | Find Object menu command is available only, if at least one structure window is 
open. 
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Find Object Ea 


Project: feptax0— i t~—<“<si‘“‘s™S™C:CSY 
Name Category: [CustomerID sti(i‘i™SOS™*~*;~;~*;”COSY 
Name: [Pumpdrive_M ator 

Structure Name: [=FunctionStuctue = stsi(‘s;s*sésS 


Apply | Cancel | Help | 


Figure 3-76. Find Object Dialog 


3.7.3.9 Split Horizontally 


Use the View | Split Horizontally menu command if you want to split the structure window 
horizontally. Then the object area will reside above the aspect area. 


3.7.3.10 Split Vertically 


Use the View | Split Vertically menu command if you want to split the structure window 
vertically. Then the object area will reside to the left of the aspect area.This arrangement is 
shown in Figure 3-77 and is the default setting at start-up of Structure Builder. 


LOL x) 


| [ p Example ProjectEXP13R0 — Project Description Type Created =) 
=P1 Ladle Tower Process Object ‘CARDRIVE_Main_Drive |Basic Property Basic Property 61998 13:36] 


B a =P2 Tundish _______ Process Object | Object CARDRIVE_Main_Drive Electrical Device Data —_EI. Device 6/19/98 13:3€ 


S) =P2=M1 CARDRIVE Drive System CARDRIVE_Main_Drive = Function Structure Structure 6419/98 13:3€ 
iy =P2=M1-O1 CARDRIVE_ Motorstarter Control Module (RRS sea Project Poo! Structure 649/98 13:3€ 
CARDRIVE. MCC Binder CARDRIVE_Main_Drive ++ Eoceaon Structure ae 28/99 15:44 

Binder CARDRIVE_RUN_R Run Right Basic Property 6419/98 1:36: 

CARDRIVE_RUN_R Libray Ref. Basic Property 6/23/98 9:42 
CARDRIVE_RUN_R DBElement DBElement 6419/98 1:36: 
CARDRIVE_RUN_R Electrical Function Data — El. Function 6/21/99 18:2€ 
CARDRIVE_RUN_R SignalParameter Parameter Aspect 6/19/98 1:36: 
CARDRIVE_RUN_R = Function Structure Structure 619/98 1:36: 
2=M1=FB_L CARDRIVE_FB_L Signal CARDRIVE_RUN_R Project Pool Structure 6/19/98 1:36: 
=P2=M1=FB_R CARDRIVE_FB_R Signal 13 |CARDRIVERUN.R == OCS-Structure Structure 6123/98 9:42 
Casting Machine Process Object CARDRIVE_RUN_L Run Lett Basic Property 6/19/98 13:37 

Torch Cutting Machine Process Object CARDRIVE_RUN_L Library Ref. Basic Property 6/23/98 9:42 

Conveyor System Process Object 418 \CARDRIVE.RUNL —DBElement DBElement 6998 13:37 
CARDRIVE_RUN_L Electrical Function Data — El. Function 6/21/99 18:27 
CARDRIVE_RUN_L SignalParameter Parameter Aspect 6/19/98 13:37 
CARDRIVE_RUN_L = Function Structure Structure 649/98 13:37 
CARDRIVE_RUN_L Project Pool Structure 619/98 13:37 
CARDRIVE_RUN_L == OCS-Structure Structure 6/23/98 9:42 


4|>f\ AspectArea / Ki wf 


Figure 3-77. Vertically Split Structure Window 
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3.7.3.11 Hide/Show Aspect Area 


Use the View | Hide/Show Aspect Area menu command if you want the aspect area to be 

hidden or visible. Alternatively you can drag the adjustable separator to modify the relation 
between object area and aspect area size. See also Figure 3-10. If the aspect area is hidden, 

certain actions run faster than with visible aspect area. 


3.7.3.12 Toolbar 


Use the View | Toolbar menu command if you want to hide or show the toolbar. When the 
toolbar is visible, this menu item is checked. The default setting is that the toolbar is visible. 


3.7.3.13 Status Bar 


Use the View | Status Bar menu command if you want to hide or show the status bar. When the 
status bar is visible, this menu item is checked. The default setting is that the status bar is 
visible. 


3.7.4 Project Menu 


3.7.4.1 Open 
See Section 3.6.2.1, Open. 


3.7.4.2 Close 
See Section 3.6.2.2, Close. 


3.7.4.3 Administration 


See Section 3.6.2.3, Administration. 


3.7.4.4 Upgrade 
See Section 3.6.2.4, Upgrade. 


3.7.4.5 Import 


See Section 3.6.2.5, Import. 


3.7.4.6 Export 
See Section 3.6.2.6, Export. 


3.7.4.7 Recent Project List 


See Section 3.6.2.7, Recent Project List. 
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3.7.5 Options Menu 


3.7.5.1 Customize Object Types 
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Use the Options | Customize | Object Types menu command create new or modify existing 
object types. The dialog shown in Figure 3-78 will be displayed: 


Customize Object Types Eg 
Object Type |_| f 
8 2'Wdg Trafo - 
@ 3 Wag Trato Edit. | 
m Actuator Delete. | 
Ml Area — 
B Article Set Cancel 
(P ausiliary System Object Rea 
f=) Batch Control Help | 


op Busbar 


"= Busbar System 
f Cabinet 
8 Cabinet Subunit = 


Figure 3-78. Customize Object Types Dialog 


The dialog consists of an object type list and some buttons. In the list the icon and the name of 
the object types are shown. You can add a new object type, modify or delete an existing one. 
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Dialog Controls 


New 


If you want to add a new object type, click New. The following dialog will be displayed. 


New Object Type Eg 
Name: | OK 


Attach Icon: 


f= artset.bmp op auxsyobj.bmp 
fap) batchetr.bmp KB bay.bmp 

[@ binder.bmp — EEEboard.bmp 
“BH breake.bmp ay building. bmp 
bus. bmp op busbar.bmp 
fim bussys.bmp f cabin.bmp 
cabinsub.bmp 

la cable. bmp (Pi channel. bmp 
chapte.bmp chunit.bmp 
@ color0.bmp = @ colorl.bmp 
@ color2.bmp = © color3.bmp 


conrec.bmp ( consunit.bmp 
EP contro.bmp (coordina bmp 
2 lt oo 


Figure 3-79. New Object Type Dialog 


Enter a new for the new object type, select an icon from the list, and click OK. You can add an 
own, additional icon to the list: Copy your bitmap file to the following project directory: 


advabldl\data\<project name>\stb\bmp\ 


<project name> has to be replaced by the actual project name. The standard bitmap size is 16 x 


16 pixels. 
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3.7.5.2 Project 
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Edit 


If you want to modify an existing object type, click Edit. The dialog shown in Figure 3-80 will 


be displayed. 


Edit Object Type xX 


New Name: 


New Icon: 


[B oard 


m actuat.bmp [channel.bmp ! ctrlobj. 


area. bm chapte.bmp Pp ctilsde 
= artset. bmp cnunit.bmp a) default 
f. auxsyobj.bmp @ colorl.bmp 7 desk.b 
fe batchct.bmp @ colorl.bmp EP dev.bn 
eS bay. bmp @ color2.bmp () devtur 
ia binder.bmp ©) color3.bmp [2] devioa 
EEE board. bmp (BD conducto.b... fi doc. bn 
t breake. bmp LA config.bmp @ docmo 
f= building.bmp 348 conn.bmp ff) docpan 
bus.bmp fg conrec.bmp (DP dives, 
P busbar.bmp a) consunit.bmp Ap dummy 
© bussys.bmp contro.bmp g&jenterp. 
a cabin.bmp a) coordina. bmp Ea? equiprr 
cabinsub.b... > couple.bmp FE] exctrl.£ 
cable.bmp fil ctrllr.bmp 2 feeder. 


+I 


Cancel | 
Help | 


Figure 3-80. Edit Object Type Dialog 


If you want to rename the selected object type, write the new name into the New Name field. If 
you want to assign another icon to it, select one from the New Icon list. 


Delete 


Click the Delete button, if you want to delete the selected object type. Multiple selection is 


possible. 


See Section 3.6.4.1, Project. 
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3.7.6 Window Menu 


3.7.6.1 Structure 


3.7.6.2 Close 


3.7.6.3 Cascade 


See Section 3.6.5.1, Structure. 


Use the Window | Close menu command if you want to close the currently active structure 
window. 


Use the Window | Cascade menu command if you want to arrange several structure windows in 
a cascading manner. Then the windows will overlap and are slightly shifted relatively to each 
other. 


3.7.6.4 Tile Horizontally 


3.7.6.5 Tile Vertically 


3.7.6.6 Arrange Icons 


3.7.6.7 Window | 1, 2... 
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Use the Window | Tile Horizontally menu command if you want to arrange several structure 
windows one above the other. 


Use the Window | Cascade menu command if you want to if you want to arrange several 
structure windows one beneath the other. 


Use the Window | Arrange Icons menu command if you want to arrange the icons of structure 
windows at the bottom of the Structure Builder window. 


. (Activate Structure Windows) 


Use the Window | 1, 2, ..(Activate Structure Window) menu command if you want to bring a 
certain structure window on top of the display. In the actual Window menu Project 1| is replaced 
by the name of an open project. If more than one project are open, they are listed in consecutive 
rows of the Window menu. 
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3.7.7 Help Menu 


3.7.7.1 Contents 


See Section 3.6.6.1, Contents. 


3.7.7.2 On Context 


See Section 3.6.6.2, On Context. 


3.7.7.3 How to Use Help 
See Section 3.6.6.3, How to Use Help. 


3.7.7.4 Release Notes 


See Section 3.6.6.4, Release Notes. 


3.7.7.5 About Structure Builder 


See Section 3.6.6.5, About Structure Builder. 
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3.8 Configuration/Application Building Menus; Aspect Context 


3.8.1 Aspect Menu 


3.8.1.1 New 


Use the Aspect | New menu command if you want to add a new aspect to the selected object. 
The command is available when you select an aspect of the corresponding object in the aspect 
area. The dialog is shown in Figure 3-81. 


Select an aspect type and click OK. 


New Aspect Ea 


Aspect Type: 
OK 


Cancel | 
Help | 


Basic Property 
Circuit 


Project Global Data 
Project OCS Defaults 


Aspect Description: 


[Node Control Software 


Figure 3-81. New Aspect Dialog 


3.8.1.2 Set Attribute 


If you want to set aspect attributes that are changeable, select the attributes in the aspect area. 
The issue the menu command Aspect | Set Attribute. The following dialog will be displayed: 


Set Attributes Ea 


Set Description: 


fal Sjonal Name = 


Selected row(s}: 1-4 


Apply | Cancel | Help | 


Figure 3-82. Set Attributes of Aspects 


In the example shown four cells of the Description attribute are selected. You can overwrite the 
value in the edit field. The new value will be set in all selected cells. 
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3.8.1.3 More ... 


Use the Aspect | More menu command if you want to administer the aspect, that you have 
selected in the aspect area of the currently active structure window. Administration can mean 
that you want to change the name of an aspect or that you want to display its structure window. 
Further on you may want to print a certain view of that aspect. If you click More then a 
submenu will be displayed. It shows at least the Open command. Some other commands may 
be available depending on the type of the selected aspect. 


The commands available under Aspect | More can also be activated from the object window 
(see Figure 3-60), which can be activated by double-clicking an Advant object in the structure 
window or with the help of the Object | Open menu command. 


If you select more than one aspect in the aspect area, then the More menu command is not 
available. 


In the following some examples of the More menu command are shown. The differences in the 
number of available submenus depend on the type of the selected aspect. 


More Menu Command for Basic Property Aspect 


When you select a basic property aspect, the Open command is the only one that is available. 
The submenu is shown in Figure 3-83. 


iG Structure Builder - [exp13r0 (otmayer): == OCS-Structure] 


Eo—eeem@ Edit View Format Project Options ‘window Help - (| x| 
New... Insert 9 | 
eit ? 
2 Set Attribute... & Lj 2 |p| 


Delete... eS 


Save As... 


Exit Alt+F4 


fy ==N2 Network 2 Net hd 


Figure 3-83. Aspect More Dialog 


When you click Open then the Set Attributes of Basic Property Aspect dialog will be 
displayed (see Figure 3-84): 


Set Attributes of Basic Property Aspect Eg 
Name Category: [Customer ID ud | 
Name: Network 1 


Type: ty [Net x] 


Cancel | Help | 


Figure 3-84. Set Attributes of Basic Property Aspect Dialog 
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More Menu Command for Structure Aspect 


When you select a structure aspect, the Open command is the only one that is available. The 
submenu is shown in Figure 3-85. 


ia Structure Builder - [exp13r0 (otmayer): == OCS-Structure] 


lee Aspect | Edit View Format Project Options ‘Window Help -/)/ x| 


Attributes 


Figure 3-85. Aspect More Dialog for a Structure Aspect 


For a structure aspect the Open menu has another submenu with an Attributes and a Structure 
command. If you click Structure the corresponding structure window will be displayed, if it is 
not already open. 


If you click Attributes then the structure aspect’s Set Attributes dialog will be displayed. It is 
shown in Figure 3-86. 


Set Attributes of Structure Aspect Ea 


~ Object Relative Reference Designation 


Prefix: Reference Designation: 


[== [2 Control: Z 7] 


Cancel | Help | 


Figure 3-86. Set Attributes of Structure Aspect Dialog 


In this dialog you can enter a relative reference designation for the Advant object. You can enter 
a prefix and the reference designation. 


Further on you can select a control that specifies the inheritance of reference designations. 
Normally reference designations reflect the hierarchy of objects. An object on the third level for 
example carries the designation from the first, the second and the third level, concatenated in a 
certain way (see Figure 3-54). It is possible to define that 


° The inheritance shall stop at a certain Advant object or 


° the inheritance shall start a new sequence of concatenations, beginning with the selected 
Advant object. 
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By default the control field is empty. The means that inheritance works as usual. If you want to 
restart at the selected object with another designation scheme, select >. The selected object will 
get the entered reference designation and the children’s designations will be concatenated in the 
usual manner. 


If you want to stop inheritance in the current structure at the selected Advant object, select < 
from the list. All children below this object will get the same reference designation. An example 
is shown in Figure 3-87: For the channel object t DSDI_110-DI.1 the control is set to < and the 
signal object assigned to this channel will get the same absolute reference designation as the 
channel. 


ié@ exp1 310 (otmayer): == OCS-Structure |. {OF x} 
2 Example Project EXP13R0 
ty Network 1 Net 
=) eg ==N1.C1 Node_1 Node 

Gl BEF ==N1.C1.D1100 DSDI_1104 Board ] 


Ff ==N7.CT.DIT00.7 DSDI_110-D1.1 Channel 


==N1.C1.DIT00.1 ALARM_1 Signal 


Project 


Figure 3-87. Example of Reference Designations with < Control 


More Menu Command for Node Control Software Aspect 


When you select a node control software aspect, the Open command gets another submenu 
which is shown in Figure 3-88. 


iw Structure Builder - [exp1310 (otmayer): == OCS-Structure] 
ice Edit View Format Project Options Window Help - |) x| 


New... Insert ) 
N ala ? 
hy Set Attribute... & La 2B |ne| 
] 


Print » 
Delete... Del Attach > Jode : 


Save As... 


Convert 
Extract 


==(5 Ni Split 


fy ==N? Netwe Eoncatenate 


==N3 Netwe LockUnlock 
Locate Circuit 


Exit Alt+F4 


Figure 3-88. Aspect More Dialog for Node Control Software Dialog 


The displayed commands offer features that will be supplied by other builders, the Application 
Builder and the Function Chart Builder. If you click for example Node Function Chart then the 
Function Chart Builder will start on the corresponding node. 


Alternatively you can start the same activity from the object window’s More button or by 
selecting a view and clicking Open (see Figure 3-60). 
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3.8.1.4 Delete 


3.8.1.5 Save As 


3.8.1.6 Exit 


3.8.2 Edit Menu 


3.8.2.1 Copy 
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Use the Aspect | Delete menu command if you want to delete one or several aspects. Select the 
aspects you want to delete and activate the Aspect | Delete menu command. 


Use the Aspect | Save As menu command if you want to store the contents of the aspect area in 
Microsoft Excel format or in tabulator separated text format. The default directory for the file is 
the project directory (\\<servername>\AdvaBld 1\data\<project name>, where AdvaBld1 is a 
share name). 


A standard Windows NT Save dialog will be displayed. 


Save List of Aspects 


Save in: Eq exp13r0 | 


Save as type: [Excel 5.0[*. xls) | Cancel | 


Figure 3-89. Save List of Aspects Dialog 


See Section 3.6.2.8, Exit. 


Use the Edit | Copy menu command aspects from one Advant object to another one. To copy 
aspects perform the following steps: 


1. Select the aspects you want to copy in the Aspect Area. 
Select the Edit | Copy menu command. 


Select the Advant objects to which you want to copy the aspects in the Object Area. 


Po oe oS 


Select the Edit | Paste menu command. 
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Alternatively you can perform the same action by dragging the selected aspects from the Aspect 
Area to one Advant object in the Object Area. Click the mouse button when the mouse cursor 
is over the border line of the selected aspects. Then the form of the cursor changes from a cross 
to an arrow: 


Cursor to select cells: cep ; cursor for drag and drop: Rs 


3.8.3 View Menu 


3.8.3.1 Expand 
See Section 3.7.3.1, Expand. 


3.8.3.2 Expand Subtree 
See Section 3.7.3.2, Expand Subtree. 


3.8.3.3 Compress Subtree 


See Section 3.7.3.3, Compress Subtree. 


3.8.3.4 Compress All 
See Section 3.7.3.4, Compress All. 


3.8.3.5 Filter Objects 
See Section 3.7.3.5, Filter Objects. 


3.8.3.6 Filter Aspects 
See Section 3.7.3.6, Filter Aspects. 


3.8.3.7 Sort Aspects 
See Section 3.7.3.7, Sort Aspects. 


3.8.3.8 Find Object 
See Section 3.7.3.8, Find Object. 


3.8.3.9 Split Horizontally 
See Section 3.7.3.9, Split Horizontally. 
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3.8.3.10 Split Vertically 
See Section 3.7.3.10, Split Vertically. 


3.8.3.11 Hide/Show Aspect Area 


See Section , Split Vertically. 


3.8.3.12 Toolbar 
See Section 3.7.3.12, Toolbar. 


3.8.3.13 Status Bar 
See Section 3.7.3.13, Status Bar. 


3.8.4 Format Menu 


3.8.4.1 Font 


Use the Format | Font menu command if you want to select another font to be used for the 
display of the aspect area of the currently active structure window. 


Default Font HE 


Font: Font stule Size: 


arial Regular [8 
= ts = = Cancel | 


Arial Black 
FH Arial Narrow 
FH BankGothic Lt BT 
Ey BankGothic Md BT 
Book Antiqua 
Fh Bookman Old Style | fia | 
Sample 
| ascoryze 
Script: 


[western ¥ 


Figure 3-90. Format - Font Dialog 
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Dialog Controls 


Font 
Lists the available fonts. 


Font Style 
Lists the available styles for the specified font. 


Size 
Lists the available point sizes for the specified font. 


Sample 
Shows a sample of how text will appear with the specified font settings. 


Script 
Lists the available language scripts for the specified font. Pick the one appropriate for the 
language your computer is set up for. 


3.8.4.2 Alignment 


Use the Format | Alignment menu command if you want to specify how text shall be aligned in 
the aspect area of the currently active structure window. Then the following dialog is displayed: 


Alignment Ea 
- Horizontal — Vertical —— 


feresocsen, 


o i CI | cancel _| 


™ Center @ Center 
™ Right ™ Buttom 
T Word Wrap 


Figure 3-91. Format - Alignment Dialog 


You can determine the alignment for individual cells. 


Dialog Controls 
Horizontal 


Left 
To align the text in the selected cells to the left, click Left. 


Center 
To center the text in the selected cells, click Center. 


Right 
To align the text in the selected cells to the right, click Right. 
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3.8.4.3 Row Height 
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Vertical 


Top 
To align the text in the selected cells to the top, click Top. 


Center 
To center the text in the selected cells, click Center. 


Bottom 
To align the text in the selected cells to the bottom, click Bottom . 


Word Wrap 
To align multiple lines of text within a cell, check the Word Wrap check box. 
Note, that the row height must be adjusted properly to see multiple lines within a cell. 


Use the Format | Row | Row Height menu command if you want to specify the height of an 
individual row in the aspect area of the currently active structure window. Then the following 
dialog is displayed: 


Row Height Ed 


I Use Default Change Default | 
Units: [Centimeters ¥] 


Figure 3-92. Format - Row Height Dialog 


Dialog Controls 


Auto 
Click Auto to let Structure Builder determine the row height, that fits best to the current font 
settings. 


Custom 
Select Custom if you want to specify the row height. Then enter the value in the field below the 
custom button. 


The actual height of the selected cells is displayed. If cells with different height are selected, the 
height of the cell with a white background is displayed. 


Use Default 

You can specify a default height and you can determine whether the default setting shall be 
used or not. If you check the Use Default check box, all rows will get the specified height. 
The former settings will be lost. 
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3.8.4.4 Column Width 


3.8.4.5 Autofit 
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Units 
Select one of the possible units. 


Change Default 

You can specify a default height and you can determine whether the default setting shall be used 
or not. If you check the Use Default check box, all rows will get the specified height. The 
former settings will be lost. 


Use the Format | Column | Column Width menu command if you want to specify the width of 
selected columns. Then the following dialog is displayed: 


Column Width Ea 
Width 
OK 
aay 
Cancel | 


T Use Default 


Units: [Characters 7] Change Detaut | 


Figure 3-93. Format - Column Width Dialog 


When the dialog is displayed, it shows the current width of the selected column or cell. You can 
overwrite this value to adapt the column width to your own needs. 


Dialog Controls 


Width 
The actual width of the selected cells is displayed. If cells with different width are selected, the 
width of the cell with a white background is displayed. 


You can specify a default width and you can determine whether the default setting shall be used 
or not. If you check the Use Default check box, all columns will get the specified width. The 
former settings will be lost. 


Units 
Select one of the possible units. 


Change Default 

You can specify a default height and you can determine whether the default setting shall be used 
or not. If you check the Use Default check box, all rows will get the specified height. The 
former settings will be lost. 


Use the Format | Column | Autofit menu command, to let Structure Builder determine the 
optimal width of the selected column(s). The autofit value is always greater than or equal to the 
default value. 
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3.8.4.6 Column Order 


Use the Format | Column Order menu command if you want to specify, which columns are 
visible in a data sheet or in the aspect area of the currently active structure window and in which 
order they appear. Then the following dialog is displayed: 


Set Column Order HEI 


Column: 


\¥|Description 

Type 

|V\Created 

\v|Created By 

| Modified 

| Modified By 

[ |Status 

|Prefix [Aspect] 

[ |Rel.Ref.Des. [Aspect] 


Figure 3-94. Format - Set Column Order Dialog 


Dialog Controls 


Column 
The Column list box list all columns available. The check box before the column name 
indicates whether the column is currently visible or not. 


Move Up 
Select a certain column and click Move Up to move it one position upwards. 


Move Down 
Select a certain column and click Move Down to move it one position downwards. 


Hide 
Select a certain column and click Hide to hide it in the aspect area. You can achieve the same 
result by clicking into the check box right to the column name. 


Show 
Select a certain column and click Show to make it visible in the aspect area. You can achieve 
the same result by clicking into the check box right to the column name. 
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3.8.4.7 Fix/Unfix Column 


Use the Format | Column | Fix Column menu command to prevent one or several columns to 
scroll horizontally, if you click the horizontal scroll bar. Before you issue the command, select 
the columns you want to fix. If there are to the left of the selected columns some columns not 


selected, these will be hidden after issuing the command. 


If columns are already fixed, you can use the Format | Column | Fix Column menu command 


to unfix them. Afterwards all columns will scroll horizontally. 


3.8.4.8 Save as Default 


Use the Format | Save as Default menu command to save your settings made with the 
commands of the Format and View menu that are relevant for the aspect area. These values are 
stored on your PC. Other members of your project may use other settings. Settings can be 


specified for the aspect area and for data sheets. 


3.8.5 Project Menu 


3.8.5.1 Open 
See Section 3.6.2.1, Open. 


3.8.5.2 Close 
See Section 3.6.2.2, Close. 


3.8.5.3 Administration 


See Section 3.6.2.3, Administration. 


3.8.5.4 Upgrade 
See Section 3.6.2.4, Upgrade. 


3.8.5.5 Import 


See Section 3.6.2.5, Import. 


3.8.5.6 Export 
See Section 3.6.2.6, Export. 


3.8.5.7 Recent Project List 


See Section 3.6.2.7, Recent Project List. 
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3.8.6 Options Menu 


3.8.6.1 Customize Object Types 


See Section 3.7.5.1, Customize Object Types. 


3.8.6.2 Project 


See Section 3.6.4.1, Project. 


3.8.7 Window Menu 


3.8.7.1 Structure 


See Section 3.6.5.1, Structure. 


3.8.7.2 Close 
See Section 3.7.6.2, Close. 


3.8.7.3 Cascade 
See Section 3.7.6.3, Cascade. 


3.8.7.4 Tile Horizontally 
See Section 3.7.6.4, Tile Horizontally. 


3.8.7.5 Tile Vertically 
See Section 3.7.6.5, Tile Vertically- 


3.8.7.6 Arrange Icons 


See Section 3.7.6.6, Arrange Icons. 


3.8.7.7 Window | 1, 2,... (Activate Structure Windows) 
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See Section 3.7.6.7, Window | 1, 2,... (Activate Structure Windows). 


3.8.8 Help Menu 


3.8.8.1 Contents 


See Section 3.6.6.1, Contents. 
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3.8.8.2 On Context 


See Section 3.6.6.2, On Context. 


3.8.8.3 How to Use Help 
See Section 3.6.6.3, How to Use Help. 


3.8.8.4 Release Notes 


See Section 3.6.6.4, Release Notes. 


3.8.8.5 About Structure Builder 


See Section 3.6.6.5, About Structure Builder. 
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Chapter 4 Runtime Operation 


4.1 Operating Overview 
Not applicable here. 


4.2 Runtime Tutorial 


Not applicable here. 


4.3 Operating Instructions 
Not applicable here. 


4.4 Runtime Operation Menus 
Not applicable here. 
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Chapter 5 Maintenance 


5.1 Error Messages 


Structure Builder displays error messages that might be generated by itself or by another 
Builder, if a problem has occurred. They will be displayed in an extra window. On top of the 
window the latest message is listed, while older ones are below. 
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Appendix A Keyboard Reference 


A.1 Special Keys for Aspect Area Navigation 


3BSE 013 932R201 


Navigation within the aspect area is possible not only with the mouse, but also with the 
keyboard. Table A-1 lists the keys you may use for navigation. The cells in the aspect area may 
stay in different modes: 


Selection mode; this is the normal mode of the aspect area when you open a structure 
window. You may select one or several cells to perform an activity on those afterwards. An 
example is: Select some cells of the Description column, press the right mouse button and 
select Set Attribute... to overwrite all settings of the selected cells. The cursor in this 
mode looks like shown in Table A-1. The cell with the white background is the active cell. 


! Selection Cursor 
PRAM Sed PumpStat Global Data Pujol tet 
3 | PUMPSTAT [laine 'S Defaults ect OCS Defaults 


4 | PUMPSTAT Structure 
5 | PUMPSTAT |PumpStat Pool Structure 


Figure A-1, Selection Cursor in Aspect Area 


Cell edit mode. It is possible to select a certain cell, change the mode to cell edit mode by 
pressing <F2> and edit the text of that cell directly. Alternatively, you can just start typing 
after selecting a cell. The edit cursor looks like shown in Table A-2 for the Description 
cell of row one. This is not possible for read-only cells 


2 
4 
5 |PUMPSTAT, 


PumpStat Global Data Project Global Data 
PumpStat OCS Defaults = Project OCS Defaults 
PumpStat ++ Structure 

PumpStat Pool 


Edit Cursor 


Structure 


Figure A-2. Edit Cursor in Aspect Area 
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Table A-1. Special Keys for Aspect Area Navigation 


Action 


Key Stroke 


Place the selection cursor in upper left corner 


<Ctrl+Pos 1> 


Place the selection cursor in lower right corner <Ctrl+End> 
Place the selection cursor at the next cell below <CursorDown> 
Place the selection cursor at the next cell above <CursorUp> 
Place the selection cursor at the next cell to the left | <CursorLeft> 


Place the selection cursor at the next cell to the right 


<CursorRight> 


Switch from selection mode to cell edit mode <F2> 
Switch from cell edit mode to selection mode <Esc> 
Store value (cell edit mode) and place selection <Return> 
cursor at the next cell below 

Store value (cell edit mode) and place selection <Tab> 


cursor at the next cell to the right 


Add next cell below to the set of selected cells 


<Shift+CursorDown> 


Add next cell above to the set of selected cells 


<Shift+CursorUp> 


Add next cell to the left to the set of selected cells 


<Shift+CursorLeft> 


Add next cell to the right to the set of selected cells 


<Shift+CursorRight> 


Add all cells below to the set of selected cells 


<Shift+Ctrl+CursorDown> 


Add all cells above to the set of selected cells 


<Shift+Ctrl+CursorUp> 


Add all cells to the left to the set of selected cells 


<Shift+Ctrl+CursorLeft> 


Add all cells to the right to the set of selected cells 


<Shift+Ctrl+CursorRight> 
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Appendix B Glossary of Terms 


Administration 


All activities covering user registration and creation, renaming, backup and restore, and deletion 
of projects are summarized under the topic administration or project administration. 


AdvaBuild_engineers 


Name of a Windows NT group created for working with AdvaBuild Engineering Software. 
Via this group the access rights of users are controlled. All members of this group can access 
project data. Therefore it is necessary to be assigned to this group. 


Creation and deletion of projects is also controlled via the AdvaBuild_engineers group. But in 
addition you need the administrator password for the database user EOSTB. 


Aspect 


There are often several ways to look at an Advant object, depending on how you want to handle 
it. When for example an Advant object is representing a valve, then you might be interested in a 
drawing of that valve or in its loop. Then you may create with a corresponding Builder an 
CAEE aspect for the drawing and a control function aspect for the loop. The aspect stores the 
corresponding data. An aspect is an instance of an aspect type. Normally a Builder supplies 
some aspect types it is able to work on. You can start a Builder on an aspect by opening one of 
its views. 


Aspect Area 


The aspect area is a view into the aspect registry. It uses a spread sheet presentation style. Each 
row of the aspect area represents one aspect, each column of the aspect area one of the aspect’s 
attributes stored in the aspect registry. For each aspect additional data are stored in a Builder 
specific manner. Structure Builder stores additional data as attributes which can be displayed, 
for example, in data sheets. 


Aspect Attribute 


An attribute holds descriptive data of an aspect. 
Aspect Registry 


The aspect registry is the database of the Aspect Request Broker. All aspects of a project are 
registered there. 
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Aspect System 


The Aspect Request Broker communicates with a Builder via a so-called Aspect System 
Interface. When some Builders share an aspect system interface, these Builders are referred to 
as an aspect system. Therefore, an aspect system may consist of one or several Builders. 


Aspect Type 


Each Builder supplies several aspect types. Examples of aspect types are basic property aspect, 
structure aspect, or node control software aspect. An aspect type is designed for special tasks. 
These tasks will be performed by the corresponding Builders or aspect systems. An aspect type 
works as a template for the creation of aspects. 


Attributes 


see Aspect Attributes 


Basic Property Aspect Type 


The basic property aspect type is one of the aspect types supplied by Structure Builder. It 
holds a name and the type of an Advant object. As an Advant object may have several names, it 
may have several basic property aspects. You can refer to a specific one with the help of its 
name category, for example with Customer ID. 


An Advant object may have for example a customer ID “Turbine A” and a location ID “Turbine 
A 2nd floor’. 


Builder 


A Builder is an application that can perform dedicated tasks on aspects. Builders can cooperate 
which each other via the Aspect Request Broker. Examples of Builders are: Structure Builder, 
Function Chart Builder, Parameter Builder. 


Category 


A category is a subtype of an aspect type. The name category for example is a subtype of a basic 
property aspect. 


Child Object 


Advant objects can be visualized in a pool or in a structure window. In a structure Advant 
objects may have a parent-child relation. A parent object may contain several child objects. In 
this way you can create a hierarchy of Advant objects. Child objects can be hidden when you 
compress the parent object. 


Cooperating Mode 


Builders can work in cooperating or independent mode. In cooperating mode Builders can 
communicate via the Aspect Request Broker. They are started by the Structure Builder, when 
you open a view of a selected aspect. 
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Copy 


You can copy Advant objects between projects, structures, or within structures. In each case 
copy creates an additional Advant object. 


Command Window 


When you click in the object window the More button the so-called command window will be 
displayed. Depending on the selected aspect’s type, it will show one or several commands. The 
command window offers at least the Open command. The same window will be displayed, if 
you click in the aspect area into a cell with the right mouse button. 


Compressed Structure 


For parent objects you can specify that the structure shall be displayed in compressed form. 
Then all successive child elements are hidden. 


Database 


The data of Structure Builder are stored in an Oracle database. To be able to access these data, 
a user must be registered as a database user. The registration can be performed with the Project 
| Administration menu command. 


Data Sheet 


Besides the data stored in the aspect registry, Structure Builder stores additional data in an own 
format. These data can be presented in data sheets. For data sheets the same spread sheet 
representation as for the aspect registry is used. 


Drag and Drop 


You can move, copy, or place Advant objects between or within structures by grabbing an 
object with the mouse and positioning it at the new location while the left mouse button is 
pressed. When you release the mouse button, the object will be copied, placed or moved, 
depending on additional keys you might have pressed during the operation: Alt: move; Ctrl: 
Copy; Shift: place. If no additional key is pressed, a default operation will be performed, which 
depends on source and destination. 


Advant Object 


Advant object Technology offers a methodology to model real world objects with Advant 
objects, aspects, and views. All entities you work with during the engineering process, like main 
plant equipment, components and devices, information entities like signals, or location entities 
like areas are referred to as Advant objects. Each Advant object may have several aspects. 


EOSTB 


EOSTB is a special database user (database administrator) which has the access rights to create 
and delete projects and to change user passwords. For project administration you have to log 
into the system as EOSTB user. 
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Expanded Structure 


For parent objects you can specify that the structure shall be displayed in expanded form. Then 
successive child elements on the next lower level or on all levels are visible. 


Independent Mode 


Builders can work in cooperating and some in independent mode. In independent mode Builders 
work without Aspect Request Broker and Structure Builder. In this mode it is not possible to 
work with Advant objects, but with aspects only. 


The Function Chart Builder for example can work in independent mode. Then it will be started 
by the Application Builder. 


Menu 


Menus are part of the menu bar. When you click with the mouse on a menu bar entry, the menu 
will be displayed, which shows one or several menu commands or a submenu. If you click on a 
menu command, the command will be executed. 


Menu Bar 


The menu bar is a bar below the main window’s title bar. It holds the menu entries. 


Move 


To change the location of an Advant object in one of your structures, you can move it to another 
location in the same or in another structure. 


Name Category 


A basic property aspect type is subtyped by name categories. An example of a name category is 
Customer ID. 


Object 


see Advant object 


Object Area 


The aspect area is the upper part of a structure window (in its default representation). The lower 
part is the aspect area. The object area visualizes the hierarchy of Advant objects of a certain 
structure. 


Object Name 


The name of an Advant object. 
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Object Type 


The type of an Advant object. When you create a new Advant object, you can select among 
several types. 


Object Window 


You will see the object window when you issue the Object | Open menu command or when you 
double-click an Advant object. In the object window you see the aspects and views of the 
selected Advant object. 


Parent Object 


Advant objects can be visualized in a pool or in a structure window. In a structure Advant 
objects may have a parent-child relation. A parent object may contain several child objects. In 
this way you can create a hierarchy of Advant objects. 


Paste 


You can insert Advant objects, that you have previously copied to the clipboard with the Edit | 
Copy menu command, at the currently selected object. 


Place 


You can place an Advant object somewhere in a structure. When you place an Advant object, 
you do not create a new object. The object gets a new structure aspect containing the 
information about the new structure position. 


Pool 


The pool is a list of all Advant objects. The order the elements are listed in that list is arbitrary. 


Prefix 
The prefix determines the type of a reference designation. Some prefixes are standardized: 
7 Function reference designation 
- Product reference designation 
+ Mounting location reference designation 
++ Topological location reference designation 
Within AdvaBuild Engineering Software the following designation is used: 
# OCS item designation 
Besides these predefined prefixes, you are free to use your own prefixes. 


Further on, the prefix will be used to concatenate relative reference designations. 
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Project Administration 


Project administration covers all activities to administer projects, to assign database users, and 
to assign users to projects. 


Project Global Data Aspect Type 


At project creation time a project global data aspect will be created as an aspect of the project 
object. You cannot delete this aspect nor create another one. The project global data aspect type 
stores general information about a project. 


Reference Designation 


A reference designation designates an Advant object in a structure unambiguously (not checked 
by the system) with respect to its parent objects. Absolute reference designations consists of a 
concatenation of all relative reference designations. 


Selected Pool 


A selected pool is a special pool that is the result of a filter. It is a subset of the pool. 


SQL Statement 


SQL statements are used to specify filters for Advant objects. They are stored in files which you 
can select. 


Status Bar 


The status bar is a bar at the bottom of the application’s main window. It holds some status 
information like keyboard settings. 


Structure 


Advant objects can be related to each other hierarchically. These relations are visualized in a 
structure window. You can create several structures depending on your needs. Some predefined 
structures are available. 


Structure Aspect Type 


When you locate an Advant object in a structure, it will get an corresponding structure aspect, 
which will hold the information about the position within the structure and the object’s parent 
object. 


Subtree 


The part of a structure that holds all child objects of a certain (parent) object. It is also referred 
to as subtree. 
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Toolbar 


The toolbar is a bar locate directly below the menu bar. It offers a quick access to some of the 
most commonly used menu commands. 


User 


A member of a project must be known by the database as user. Members of the Windows NT 
group AdvaBuild_engineers can be assigned as database users and can be mapped to projects. 


View 


An aspect may have several views. You can start a Builder on an aspect by opening one of its 
views. A node control software aspect as among others for example a node function chart and a 
node structure function chart view. 
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default name category 3-61 
default status 3-61 
deleting 3-76, 3-101 
introduction 3-5, 3-7 
modified by 3-77 
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opening 3-75 to 3-76 
views list 3-76 

WwW 

windows 
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